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Important! 
Model 16 Power Up Sequence 


Before powering up your TRS-80 System, be sure the Computer is 

connected to a three—prong, grounded outlet or grounded power strip 
(such as Radio Shack’s Plug-In Power Strip, Catalog Number 61-2619). If you 
do not correctly connect and ground the Computer, you’re exposing yourself to 
the danger of electrical shock as well as endangering your Computer and data. 
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"3" Allow érié minute warm- -up for: the. disk’ tate: oo 
-4, Turn your Computer ON. 
5. Turn all peripherals (including floppy disk expansion unit and printers) ON. 


If your operating system is stéred on’ ‘floppy diskéttevanidithe Computet has, 
not been modified for hard disk; ‘the Computer’ ‘will go te Drive O-and load the 
operating system. You can then begin: usin your TRS- 80 System" gt RE 
described in your Computer’ s, owner's S mani a, “pas GE 
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If your operating system is stored on ae disk the an MS wil = to ) Drive 
4 and automatically load the operating system. -You.can then-begin/using: your 
TRS-80 System as described in Your Comiputér's,;owner’s manual. 
«.-y If your Computer has been modified for hard disk but you, wish, to 0. power up 
under floppy diskette control (Drive 0); press the *key-combihation"s aiated 
(REPEAT)(BREAK)or(REPEAT)(ESC) when the screen ‘whites 


out.’’ The Computer will then search Drive @ for an operating system. 
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When turning the power OFF........ 


Special Note for Eight Meg Drive Owners: With multiple Y 
hard disk systems, always be sure Drive 4 (the primary drive) is the 

last disk drive turned OFF. If Drive 4 is not the last drive turned off, 

data may be lost or destroyed. 


1. Turn all peripherals (including floppy disk drives) OFF. 


Eight Meg Drive Owners: Turn all 
secondary hard disk drives OFF. 


2. Turn the primary drive (Drive 4) OFF. 
3. Turn the Computer OFF. 


Thank you 


Radie Shaek 


A DIVISION OF TANDY CORPORATION 
FORT WORTH, TEXAS 76102 


8749427-1282 


Radice Shaek 


-—~ TRS-80 
MODEL 16 


TRSDOS-16 
DISK OPERATING 
SYSTEM 


CUSTOM MANUFACTURED IN U.S.A. BY RADIO SHACK, A DIVISION OF TANDY CORPORATION 


TERMS AND CONDITIONS OF SALE AND LICENSE OF RADIO SHACK COMPUTER EQUIPMENT AND SOFTWARE 
PURCHASED FROM A RADIO SHACK COMPANY-OWNED COMPUTER CENTER, RETAIL STORE OR FROM A 
RADIO SHACK FRANCHISEE OR DEALER AT ITS AUTHORIZED LOCATION 


LIMITED WARRANTY 
|. CUSTOMER OBLIGATIONS 


A. CUSTOMER assumes full responsibility that this Radio Shack computer hardware purchased (the Equipment’), and any copies of Radio 
Shack software included with the Equipment or licensed separately (the Software’) meets the specifications, capacity, capabilities, 
versatility, and other requirements of CUSTOMER. 

B. CUSTOMER assumes full responsibility for the condition and effectiveness of the operating environment in which the Equipment and Software 
are to function, and for its installation. 


I. | RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE 


A. For a period of ninety (90) calendar days from the date of the Radio Shack sales document received upon purchase of the Equipment, RADIO 
SHACK warrants to the original CUSTOMER that the Equipment and the medium upon which the Software is stored is free from manufacturing 
defects. THIS WARRANTY IS ONLY APPLICABLE TO PURCHASES OF RADIO SHACK EQUIPMENT BY THE ORIGINAL CUSTOMER FROM 
RADIO SHACK COMPANY-OWNED COMPUTER CENTERS, RETAIL STORES AND FROM RADIO SHACK FRANCHISEES AND DEALERS AT ITS 
AUTHORIZED LOCATION. The warranty is void if the Equipment’s case or cabinet has been opened, or if the Equipment or Software has been 
Subjected to improper or abnormal use. If a manufacturing defect is discovered during the stated warranty period, the defective Equipment 
must be returned to a Radio Shack Computer Center, a Radio Shack retail store, participating Radio Shack franchisee or Radio Snack dealer 
for repair, along with a copy of the sales document or lease agreement. The original CUSTOMER'S sole and exclusive remedy in the event of 
a defect is limited to the correction of the defect by repair, replacement, or refund of the purchase price, at RADIO SHACK’S election and sole 
expense. RADIO SHACK has no obligation to replace or repair expendable items. 

B. RADIO SHACK makes no warranty as to the design. capability, capacity. or suitability for use of the Software, except as provided in this 
paragraph. Software is licensed on an ‘AS |S’ basis. without warranty. The original CUSTOMER'S exclusive remedy, in the event of a 
Software manufacturing defect, is its repair or replacement within thirty (30) calendar days of the date of the Radio Shack sales document 
received upon license of the Software. The defective Software shall be returned to a Radio Shack Computer Center, a Radio Shack retail store, 
participating Radio Shack franchisee or Radio Shack dealer along with the sales document. 

C. Except as provided herein no employee. agent, franchisee. dealer or other person is authorized to give any warranties of any nature on behalf 
of RADIO SHACK. 

D. Except as provided herein, RADIO SHACK MAKES NO WARRANTIES, INCLUDING WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A 
PARTICULAR PURPOSE. 

ES Some states do not allow limitations on how long an implied warranty lasts, so the above limitation(s) may not apply to CUSTOMER. 


Ill. LIMITATION OF LIABILITY 


A. EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY OTHER PERSON 
OR ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY 
“EQUIPMENT” OR “SOFTWARE” SOLD, LEASED, LICENSED OR FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO, ANY 
INTERRUPTION OF SERVICE, LOSS OF BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE 
USE OR OPERATION OF THE ‘‘EQUIPMENT” OR “SOFTWARE”. IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR LOSS OF PROFITS, OR 
ANY INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY BREACH OF THIS WARRANTY OR IN ANY MANNER 
ARISING OUT OF OR CONNECTED WITH THE SALE, LEASE, LICENSE, USE OR ANTICIPATED USE OF THE “EQUIPMENT” OR “SOFTWARE”. 


NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK’S LIABILITY HEREUNDER FOR DAMAGES INCURRED BY 
CUSTOMER OR OTHERS SHALL NOT EXCEED THE AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR “EQUIPMENT” OR “SOFTWARE” 
INVOLVED. 

B. RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing Equipment and/or Software. 

C. No action arising out of any claimed breach of this Warranty or transactions under this Warranty may be brought more than two (2) years 
after the cause of action has accrued or more than four (4) years after the date of the Radio Shack sales document for the Equipment or 
Software, whichever first occurs. 

D. Some states do not allow the limitation or exclusion of incidental or consequential damages, so the above limitation(s) or exclusion(s) may 
not apply to CUSTOMER. 


IV. RADIO SHACK SOFTWARE LICENSE 


RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the RADIO SHACK Software on one computer, subject to the following 

provisions: 

. Except as otherwise provided in this Software License, applicable copyright laws shall apply to the Software. 

B. — Title to the medium on which the Software is recorded (cassette and/or diskette) or stored (ROM) is transferred to CUSTOMER, but not title to 
the Software. 

C. CUSTOMER may use Software on one host computer and access that Software through one or more terminals if the Software permits this 

function. 

CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for use on one computer and as |s specifically 

provided in this Software License. Customer is expressly prohibited from disassembling the Software. 

a CUSTOMER is permitted to make additional copies of the Software only for backup or archival purposes or if additional copies are required in 
the operation of one computer with the Software, but only to the extent the Software allows a backup copy to be made. However. for 
TRSDOS Software, CUSTOMER is permitted to make a limited number of additional copies for CUSTOMER'S own use. 

F CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has purchased one copy of the Software for each 
one sold or distributed. The provisions of this Software License shall also be applicable to third parties receiving copies of the Software from 
CUSTOMER. 

G. All copyright notices shall be retained on all copies of the Software. 


V. APPLICABILITY OF WARRANTY 


A. — The terms and conditions of this Warranty are applicable as between RADIO SHACK and CUSTOMER to either a sale of the Equipment and/or 
Software License to CUSTOMER or to a transaction whereby RADIO SHACK sells or conveys such Equipment to a third party for lease to 
CUSTOMER. 

B. The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO SHACK, the author, owner and/or licensor of the 
Software and any manufacturer of the Equipment sold by RADIO SHACK. 


Vi. STATE LAW RIGHTS 


The warranties granted herein give the original CUSTOMER specific legal rights, and the original CUSTOMER may have other rights which vary 
from state to state. 


TRSDOS™-16 
DISK OPERATING SYSTEM 
OWNER’S MANUAL 


TRSDOS™-II Operating System: Copyright 1982 Tandy Corporation. All Rights Reserved. 
TRSDOS™-16 Disk Operating System Manual: Copyright 1982 Ryan-McFarland Corporation. 
All Rights Reserved. Licensed to Tandy Corporation. 


TRSDOS™-16 Disk Operating System Manual: 
Copyright 1982 Tandy Corporation. All Rights Reserved. 


Reproduction or use without express written permission from Tandy Corporation, of any portion of this 
manual is prohibited. While reasonable efforts have been taken in the preparation of this manual to 
assure its accuracy, Tandy Corporation assumes no liability resulting from any errors or omissions in 
this manual, or from the use of the information contained herein. 
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INTRODUCTION 


WHAT IS AN OPERATING SYSTEM? 


An operating system is a low level program which monitors 
and controls your entire computer system. 


This includes the your computer's two microprocessors, as 
well as the disk drives, keyboard, printer, and all other 
equipment. 


It is the operating system which enables you to use 


application programs (such as PAYROLL, PROFILE, and MAILING 
iS Sl ee re 


WHAT IS TRSDOS-16? 


TRSDOS-16 is one operating system you can use with your 


computer. It uses both of the computer's microprocessors -- 
the 78M and the MC689QQ@. 
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ABOUT THIS MANUAL 


This manual shows how you can use the TRSDOS-16 operating 
system to: 


‘ write TRSDOS-16 programs 
‘ store, retrieve or manipulate information 
On aisk, 


In the Operator's Read Me First Manual, we covered all the 
essential information to get you started. This means if 
you're not a programmer, you do not need to read this 
manual. 


If you are a programmer, you'll find a lot of useful 
information in this manual: 


SECTION I/ USING TRSDOS-16 describes how to start-up 
TRSDOS-16, what TRSDOS-16 Ready means, and some general 
information on how TRSDOS-16 works. 


SECTION II/ TRSDOS-16 SYSTEM COMMANDS contains a 
number of commands you will find helpful. 


SECTION III/ TECHNICAL INFORMATION explains 

how to use TRSDOS-16 on a technical level. 

Besides providing useful technical information, 
this section lists many TRSDOS-16 routines (called 
Supervisor calls or SVCS) which you can call from 
your machine-language program. 


SECTION IV/ THE APPENDICES contains more information, 
including memory maps, error messages, and codes 
useful in writing programs. 


This manual describes TRSDOS-16 only. For information on 


other operating systems, see the reference manuals that come 
with them. 
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NOTATIONS 


For clarity and brevity, we use some special notations and 
type styles in this book. 


CAPITALS and punctuation 
indicate material that you must enter exactly as it appears 
or material that you see on your Computer's video display. 


<KEYBOARD CHARACTER> 
indicates keys you press. 


lowercase underlined 
represent words, letters, characters or values. 


H'nnnn 

specifies nnnn as a hexadecimal (base 16) number. All other 
numbers in the text of this book are in decimal (base 19) 
form, unless otherwise noted. 


TERMS 


Below is a listing of terms which we use frequently in this 
manual. The underlined words represent variable information 
which you must supply. 


command represents the TRSDOS-16 command you want to 
execute. 


comment is an optional field used to document the purpose 
of the command line. 


{options} is a list of one or more parameters that may 
be needed by the command. Some commands have no 
options. The braces { } around options can 
usually be omitted if you don't use a comment at 
the end of the command line. 


filespec is a standard TRSDOS-16 file specification 
having the general form: 


filename/ext.password:drive(disk name) 


hard disk refers exclusively to a hard disk (Drives 4 - 7). 
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diskette refers exclusively to a floppy diskette 
(Drives @ - 3). 
disk refers to a disk that can be either a hard disk or 


a floppy diskette (Drives @ - 7). 


primary drive refers to the disk drive that contains the 
operating system information Drive @ or 4). 


Radie Shaek 


TRSDOS-16 OWNER'S MANUAL INTRODUCTION 
TRS-SO * 
TABLE OF CONTENTS 
PAGE 
PE CON 6 ied oe cok Wg, Ne nce: nea a ete ane a eae a owe Nt 1 
DOME 0 i Maa nis aaa tua) op ogy a gerne Sue gna ie oy Utes 3 
NOGAe TONS. ane. Hes gia otie ore amare one ete Ma cn eke 5 
SECTION I/ USING TRSDOS-16 
How the Computer Uses: “TRSODOS=264-.% 65 eS eso 8405.05 4% ded. 
ome ghd: hes = On 24 oe ae Sew Bee wee a eee a ee a 11 
What Does TRSDOS-16 Ready Mean? ......ccccccccccece 12 
Ee eS cee ve eee ea cee ate Bey eee ty a eae gs at ae 14 
SOMpLe: URSlCI Sei est Lhe ee eee oe ee Re ee ees 18 
SWapD Lid DUS KerCSs ious ds eee oe ea Cee aw eee es 21 
SECTION II/ TRSDOS-16 SYSTEM COMMANDS 
TE ICO harais eiey et e a Win Sacco eg etek ae ene a eras ane eee 25 
HOW: TO Se Ths SeCELOn 6.64 bee oes SALE ae ere eek 26 
ORUCSH oe Malo are a Sle) 111 (a ote k= Uae Ren ene a ag eee REN ON eed Ere eR ae 29 
SECTION III/ TECHNICAL INFORMATION 
MENOLYy REGU remencs 244-5 Gos haw oe Dadi a Giese ee es 195 
DAG ORG AU AS a WOM eyo: d.y are ue eee eae Oe Se a ew es 198 
Se OE Ss Eee ayn y aves Bite ea Wegner aa ee ew ene! ak aa LiL3 
SUPSEVASOE (Cal) Gai wis wc eee are Bole eae oe EL es LZZ 
SG ee Ward hareouste Wa eed atte Bh eee ere Aten e eee P25 
Progzanming Wren Ueer Tnterrupes 5204. ey eee bax Ze 
Ct A GOR In Bi wil 6 (0 fo See eee ae eC NS ON eT Ce Se ees ero tee a ee RAEN T 129 
SECTION IV/ APPENDICES 
Py EOL Mes eades esata neo Gate a gry Rage eat dhe eg aes 221, 
By he Conriguration Conmivena Prles 0%... 4 44.4 ae es 233 
CPM EINOT Vectla it ata tees fe beg eas Al a cs el hier the een an 239 
DY REO Ll Cree aeGer (Cote nat oe ocak bane gamers. cian 240 
Hy “SVG OUrek. RETSrence T1564 ok i gee e hig oe ee Ses 244 


Radie Shaek 


TRSDOS-16 OWNER'S MANUAL Rs USING TRSDOS-16 
TRS-8SO 


HOW THE COMPUTER USES TRSDOS-16 


Whenever you are uSing a TRSDOS-16 program, your computer 
will, from time to time, need to reference TRSDOS-16. It 
always looks for TRSDOS-16 on the primary drive. 


The primary drive is: 


Drive 0 -- if you start up your system under floppy 
aLsk -eontro. 


Drive 4 -- if you start up your system under hard 
disk control. (It may be your only hard 
disk drive) 


For this reason, if you have a floppy disk system (that is, 
you don't have the optional hard disk) or if you have a hard 
disk system and are operating under floppy disk control, you 
must at all times have a diskette containing TRSDOS-16 in 
Drive 0. 


Tf you have a hard disk system and want to operate under the 
control of your hard disk, you need to copy TRSDOS-16 onto 
your primary drive. The Operator's Read Me First Manual 
shows how. 


LOADING TRSDOS-16 


When you install and power up your system, you'll see the 
TRSDOS-II start-up logo. This means you're in the TRSDOS-II 
Operating System. You then need to enter the date and time. 
Enter the date in the MM/DD/YYYY form. For example, type: 


08/21/1982 <ENTER> 
for August 21, 1982. You now will be prompted to enter the 
time. You can skip this question by simply pressing 


<ENTER>. The time will start at 00.00.00. 


If you want to set the time, type the time in the 24-hour 
format -- HH.MM.SS. The seconds are optional. For example, 


type: 
14.30 <ENTER> 
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for 2:3 pit. 


After entering the date and time, the TRSDOS-16 Operating 
System AUTOmatically loads and displays: 


TRSDOS-16 Ready 


This indicates that you are at the 689@@ Disk Operating 
System's command level. 


NOTE: A factory-set AUTO command loads the TRSDOS16/SYS 
program -- the 689@M operating system. It then loads a 
configuration command file named CONFIG16/SYS which links 
certain extra operating system modules into memory. If you 
want to save memory or change the configuration command 
file, see Appendix B. 


To override this factory-set AUTO command, see AUTO in 
SE LILON. fs 


You can also load TRSDOS-16 from the TRSDOS-II Ready prompt 
by typing: 


BOOT16 TRSDOS16/SYS <ENTER> 


WARNING: DO NOT press <BREAK> when you are loading the 
TRSDOS-16 operating system. If you do, your computer may 
become confused if interupted while doing the configuration. 


If you accidentally press <BREAK>, you will have to power 
down your system before trying to load TRSDOS-16 again. 


WHAT DOES TRSDOS-16 READY MEAN? 

Whenever you see the TRSDOS-16 Ready prompt you know that 
you are in control of TRSDOS-16 -- not COBOL, PAYROLL, or 
any of your application programs. Being in control of 
TRSDOS-16 allows you to do one of these operations: 


° execute a system command 
° execute a program 


If you want to perform any other operation, you need to be 
in control of an application program. 
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When you are in control of TRSDOS-16 and an error occurs, 
you'll get one of the error messages listed in Appendix A. 


If you get an error message not listed, it came from an 
application program that is running. You'll need to see the 
manual which came with the application program for an 
explanation of the error message. 


EXECUTING A COMMAND 


You can execute a TRSDOS-16 system command whenever you see 
the TRSDOS-16 Ready prompt. The command you type can consist 
of up to 8@ characters. You must end the command by 
pressing <ENTER>. 


For example, if you want to see the TRSDOS-16 system 
commands, type: 


LIB <ENTER> 


TRSDOS-16 displays a list of all the available system 
commands and returns to TRSDOS-16 Ready: 


APPEND ASSIGN ATTRIB AUTO BACKUP CLEAR CLS COPY 
CREATE DATE DEBUG DIR DISMOUNT DO DRIVE DUMP 
EAEG FCOPY PILES FLOPPY FORMAT FORMS FREE HELP 
WiLL LIB Lee LOAD MOUNT MOVE MSG PATCH 
PAUSE PRINT LIS PURGE RELEASE RENAME RESET RESTORE 
SAVE SETCOM ap ae SPOOL TERMINAL TIME VERIFY VERSION 


EXECUTING A PROGRAM 


You can also execute a program (such as the Editor) at the 
TRSDOS-16 Ready prompt. If what you enter is not a 
recognized system command, TRSDOS-16 checks to see if it is 
the name of a 689@@ program. It checks for the program file 
on ali drives, beginning with the primary drive (Drive @ or 
Drive 4) unless you specify drive number. 


If TRSDOS-16 finds a matching 689@@ program file, it loads 
and executes the file. Otherwise, you get an error message. 
For example: 
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EDIT16 <ENTER> 


loads the Editor program. Now you can create a program or 
edit an existing one. 


DISK FILES 


You can keep a record of anything you type into your 
computer by storing it on disk (hard or floppy) ina "disk 
file". A disk file can contain a program, a collection of 
data, a project report you intend to make, or almost 
anything you want it to contain. But, whatever it is, if 
you want to keep it permanently, you'll have to store it in 
a disk file. 


When the computer stores the file, it indexes the name of 
the file and it's disk location in a special place on the 
disk called the disk's directory. Whenever you want to 
access the file, the computer can immediately find its 
location by uSing this directory. 


If you want to see how a disk file is created and stored, 
see the SAMPLE EXERCISE/ CREATING A DISK FILE later in this 
chapter. 


PILESPEC 


Whenever you create a disk file, you need to give it a name. 
This name is just one part of a file specification -- 
filespec, for short. The filespec is the standard 


TRSDOS-16 format you'll use every time you reference your 
file: 


filename/ext.password:drive(disk name) 


filename 

The name of your file can be anything you like, as long as 
it is one to eight alphanumeric characters, the first of 
which must be a letter. For example, if you want to save a 
file containing an inventory list, you could simply name it: 


INVNTRY 
extension 


If you want to further identify your file, you can give ita 
second name by adding an extension. An extension (indicated 
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by /ext on our filespec) is a sequence of one to three 
alphanumeric characters with a preceding slash (/). 


You can use an extension to provide additional information 
on a file. For example, with an extension such as /NEW, 
/IRS, or /PAY, you could distinguish files with the same 
name or divide files into categories. 


You can also use an extension to indicate the type of file 
you have. The extension /BAS indicates a BASIC program 
file; /DAT indicates that a file contains data only; or /SRC 
defines a SOURCE file. 


With the extension /DAT, the new name of our inventory file 
is: 


INVNTRY/DAT 


password 
Some files allow you to protect them. You can accomplish 


this protection via a password either when you create the 
file or with the command ATTRIB. 


A password is a sequence of up to eight alphanumeric 
characters, the first of which must be a letter, with a 
period (.) preceding it to separate it from the filename. 


There are two levels of passwords and the protection they 
provide -- access passwords and update passwords. These 
passwords not only can inhibit entry to a file, they also 
can provide protection at varying levels. 


When you initially create a file and assign a password, the 
access and update passwords are the same. Later, if you 
choose, you can change these values with the system command 
ATTRIB and thus provide the additional protection to your 
files. (See ATTRIB for details.) 


With the password Sesame, the new name of our inventory file 
is: 
INVNTRY/DAT.Sesame 
drive 
Often when you're using your computer, you'll have more than 


one disk in use. Whether these disks are floppy or hard, 
you can speed up the file access time by specifying the 


Radie Shaek 


LS 


TRSDOS-16 OWNER'S MANUAL é USING TRSDOS-16 
TRS-8O 


drive the desired file is on. Use the form :drive for the 
drive number. 


If you omit a drive number on the filespec, your computer 
automatically starts looking for the file on all available 
drives, beginning with the primary drive. 


To indicate your inventory file's location on the filespec, 
type: 


INVNTRY/DAT. Sesame: 2 


See your Operator's Manual or Hard Disk Manual if you are 
not sure what your drive numbers are. 


disk name 

You may want to indicate the name of the disk that a file is 
on. The disk name was assigned when you formatted or 

backed up the disk. 


It takes the form (disk name), which is a field of up to 
eight alphanumeric characters, the first character being a 
letter, with parentheses ( ) surrounding the entire name. 
If you specify the disk name, you must also specify the 
drive number. 


Now, if you're ready to reference your inventory file, enter 
this complete filespec to ensure that you're getting the 
right one: 


INVNTRY/DAT. Sesame: 2 (WREHSE) 


Of course, every filespec you enter won't include all of 
these optional specifications, however, you can use any 
combination of the fields as long as you follow the 
guidelines indicated. 


Here are some more examples of valid TRSDOS-16 filespecs: 


DOPROG .OPEN 
CLR/BAS :1 
MOD16:4(TRSDOS16 ) 

STLI2/ TXT Arch: LCTRAVLS2 > 
GAME1 

THESIS/OLD: 2 

CONTEMP: 3 
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Wildcards 


Certain system commands and SVC's allow you to specify a 
collection of files by using a "wildcard" mask. An asterisk 
"*" in a file specification represents a wildcard field and 
means "any sequence of zero or more characters". For 
example: 


*/BAS:1 


represents all the files stored on the diskette in Drive l 
having the extension /BAS. 


D* 


represents all the files on the disk in the primary drive, 
beginning with D, without extensions. 


AS an example use, if you want a DIRectory of all the files 
with an extension that begin with the letter D, type: 


DIR D*¥/* <ENTER> 


TRSDOS-16 returns a listing of all the files beginning with 
D and having extensions: 


Disk Name: TRSDOS Drive:4 04/09/82 1 "4 at I | 
File Name Created Updated Atrkh Fil Rec # af --——=—Sectap gm 
MM/DD/YY MM/DD/YY Tre Len Recards Allac Used 
DATM32/ TXT 04/09/82 04/09/82 D¥xX@ V be wt 1 1 
DOBUDGET/SRC 04/09/82 04/09/82 D*¥X@ V pt +4 1 1 
DEMOPROG/ 1 04/89/82 04/09/82 D¥xX@ V t+ tot 1 1 
DIRECAC/FLE 24/09/82 04/09/82 D¥X@ V oe +++ 1 1 


4 Files Displayed 


Super Wildcard 


Besides the wildcard "*", TRSDOS-16 has a super wildcard -- 
"It". You can use it to specify all files, with and without 
extensions. 
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For example, if you want to FCOPY all files from a diskette 
to hard disk, you can use the super-wildcard. This 
accomplishes in one step what it would take the wildcard two 
steps to do: 


FCOPY */*:1 TO 4 <ENTER> 
FCOPY *:1 TO 4 <ENTER> 


Here, the first command FCOPYs files with extensions. The 
second then FCOPYs files without extensions. But, if you 
use the super wildcard and type: 


FCOPY isl. TO 4 <ENTER> 


TRSDOS-16 FCOPYs all files on the diskette in Drive l to 
hard disk in one step. 


You can use the wildcard and super wildcard with these 
system commands: 


DIRectory 
FCOPY 
KILL 

MOVE 


SAMPLE EXERCISE/ CREATING A DISK FILE 


This is an example of how to create a command file and then 
save it to disk. When run, the file will automatically 
clear the screen and print the date and time in the top left 
hand corner of the screen. This command file -- known as a 
DO-file -- iS a program made up of one or more system 
commands or programs that is executed with the command DO. 


To create this file, you must first enter the Editor and its 
Insert mode by typing: 


EDIT16 <ENTER> 
IN <ENTER> 


(See the DO command in this manual for further information. ) 
Now you should be in the insert mode (with the prompt I?) 
where you can type in the command lines: 


CLS <ENTER> 
MSG "TODAY'S DATE IS:" <ENTER> 
DATE <ENTER> 
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<EN TER> 


At this point, the command file is in the computer's memory. 
If you want to keep or run it, you'll have to save it ina 
disk file. Type: 


SAVE MYPROG <ENTER> 


and the Editor writes your program, with the name MYPROG, to 
disk. Now you have a permanent copy. 


Exit the Editor by typing QU <ENTER>. 
To run your DO-file, type: 
DO MYPROG <ENTER> 


TRSDOS-16 will clear your screen and display: 


TODAY'S DATE IS: 
Fri May 14 1982 134 -- 19.24.39 
TRSDOS-16 Ready 


oeoe0eoeoeo3eoeoeeec0ee3eoeeee3eeeeeeeeeeeeeee3ewtee3nee3eeeeee3uaweee5uauo3sesee3ee 


Sometime in the future, you may want to run MYPROG again, 

but you've forgotten the exact filename you gave it. You 

can look at the directory (as we mentioned earlier) to see 
how it's filed. Type: 


DIR <ENTER> 


for a directory listing of the disk in Drive 4. TRSDOS-16 
returns a DIRectory listing like this: 
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USING TRSDOS-16 


TRS-8O * 

Disk Name: TRSDOS Drive ?4 04/09/82 OY. 25.52 
File Name Created Updated Atrb Fil Rec # of meee ctar gnc 
MM/DD/YY MM/DD/YY Trp Len Records Allac Used 
DESIGNZ 04/05/82 04/05/82 P#X@ F 236 2 2 Z 
READ/ME 24/05/82 04/05/82 D¥XO F 256 Pes rad gs 
TRSDOS1I6/SYS 03/26/82 04/16/82 D¥X@ F 256 107 187 147 
CONFIGI6/SYS 03/26/82 04/16/82 D¥X@ V +4 + tet 1 1 
ASM16 Q@2/25/82 04/16/82 D#¥X@ F 296 148 148 149 
LINK16 O2/25/82 04/16/82 D¥X@ F 256 64 b4 64 
EDIT16 03/27/82 04/16/82 D¥XO F 256 52 5@ 50 
BOOTISG 04/23/82 04/16/82 P¥X@ F 256 & & & 
IFC 04/83/82 04/16/82 P#X@ F 256 is : aR 1 
RUNCOBOL/SYS O@3/27/82 04/16/82 D¥X@ F 2096 6B 68 68 
VIDTEX 10/13/80 04/07/82 D¥X@ F 1 +++ 13 +++ 
SAMPLEI/PRO 04/09/82 04/09/82 D¥xX@ V Se t+ 2 4 
DATM32/ TXT 04/09/82 04/09/82 D¥x@ V ee +44 1 1 
DOBUDGET/SRC 04/09/82 04/09/82 D¥X@ V ot +t 1 1 
DEMOPROG/ 1 04/09/82 04/09/82 D¥X@ V + ae oa 1 1 
DIRECAC/FLE 04/09/82 04/09/82 D¥X@ V +++ det { { 
MYPROG 04/09/82 04/09/82 D¥X@ V +++ tet 1 1 


17 Files Displaved 


You can also use a wildcard to find the filename you want. 


For example, if the filename does not have an extension, you 
can avoid a long directory listing that consists of all 
files with and without extensions by typing: 


DIR: * <ENTER> 


TRSDOS-16 returns a directory listing that is substantially 
shorter because it only lists the files without extensions: 


Disk Name: TRSDOS Drive :4 44/09/82 00.26.21 
File Name Created Updated Atrh Fil Rec # of ie Rear r sa 
MM/DD/YY MM/DD/YY Tre Len Records Alloac Used 
DESIGN2Z 04/05/82 04/05/82 P#X@ F 256 4 z me 
ASM1& 2/25/82 04/16/82 D¥XO F 256 148 148 148 
LINK16 02/25/82 04/16/82 D¥X@ F 256 64 64 64 
EDIT16 03/27/82 04/16/82 D¥X@ F 250 5@ 5@ 5@ 
BOOT164 04/03/82 04/16/82 P#X@ F 256 & re ron 
Les 04/03/82 04/16/82 P¥X@ F 256 1 13 pee 
ViIDLEX 14/13/80 04/07/82 D¥X@ F 1 +++ 13 a on 
MYPROG 04/09/82 04/09/82 D¥X@ V the bt 1 1 
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SWAPPING DISKETTES 

Whenever you want to change the diskettes in any of your 
Floppy drives, you must perform the DISMOUNT/MOUNT 
operations. (NEVER change a diskette when a file on that 


diskette is in use or open.) 


To swap diskettes, first remove the diskette(s) you want to 
change and type: 


DISMOUNT <ENTER> 


This informs TRSDOS-16 that you have just removed diskettes 
from the drives. 


TRSDOS-16 returns the prompt: 
INIT DONE 
Insert other diskettes, close the drive door, and type: 
MOUNT <ENTER> 
Again TRSDOS-16 will acknowledge the change of diskettes 
with: 
INIT DONE 
You can begin using the diskettes. 


(See the MOUNT and DISMOUNT commands in the next section for 
more information. ) 
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TRSDOS-16 SYSTEM COMMANDS 


TRSDOS-16 system commands (typed in at the TRSDOS-16 Ready 
level) perform a variety of helpful operations: 


Diskette Handling commands allow you to prepare your blank 
diskettes for use or make copies of existing diskettes. 
Anytime you use a blank diskette, you should use one of 
these commands: 


FORMAT | 
BACKUP 


If you want to change the way your computer system starts up 
and initializes its parameters, you can use Initialization 
commands. For example, you can use the FORMS command to set 

your printer's parameters; or you can use the AUTO command 

to set your computer to AUTOmatically perform a particular 

function at start-up. The Initialization commands are: 


AUTO FORMS 

DATE MOUNT 

DISMOUNT RESET 
a DRIVE SETCOM 
| FLOPPY TIME 


You might find the Auxiliary commands helpful for such 
functions as seeing what is on your disk, printing some of 
your disk files, or simply seeing what system commands are 
available. They include: 


CLEAR LIB SIZE 

CLS LIST SPOOL 

DIR MSG T 
DO PATCH TERMINAL 
FILES PAUSE VERIFY 
FREE PRINT VERSION 

HELP 


The File Handling commands allow you to copy, rename, or 


delete your disk files. These commands include: 
APPEND MOVE 
ATTRIB PROT 
COPY PURGE 
CREATE RENAME 
FCOPY RESTORE 
® 
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KILL SAVE 


Machine Language File Handling commands create and execute 


machine language disk files. These commands include: 


DUMP LOAD 
EXEC 


HOW TO USE THIS SECTION 


This section contains an alphabetical listing of each system 
command, with each listing divided into several parts. 


The command syntax is the first line you'll see after the 
command keyword. Use it as your guide to type in a system 
command. (See SYNTAX below for a detailed explanation) 


Following each syntax is a definition of the system command. 
This tells you exactly what the specific command does. 


Next is additional information on the parameters of the 
command; i.e., what are the values you must supply, what is 
optional information, and what these options do when 
included in the command. 


After this optional information, you'll find further 
explanation of the command, including special instructions 


on the command, switches, and how best to use the command 
for your purposes. 


Finally, each section gives you examples of the command's 
use. 


SYNTAX 


The command's "syntax" tells you what format to use when you 
type the command. 


For example, the syntax for the CLS (CLear Screen) command 
is simply: 


CLS 


CLS <ENTER> is all you need to type to execute this command. 
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The syntax for the KILL command includes a parameter (a 
value you supply): 


KILL filespec 


In this case, the parameter is a TRSDOS-16 filespec 
(discussed in Chapter 1). For example, if you want to kill 
the disk file named SAMPLE in Drive 1, you could type: 


KILL SAMPLE:1l <ENTER> 


Still other commands require additional parameters, such as: 


COPY source filespec TO destination {option } 


Here you must supply the name of the source filespec you 
wish to copy and the destination where you want it copied. 
For example: 


COPY NEW/DAT:1 TO NEWDAT/1:2 <ENTER> 


makes a copy of the file NEW/DAT, from the diskette in Drive 
1, onto the diskette in Drive 2, and then names the new file 


“™ NEWDAT/1. 


Sometimes additional information is required; sometimes it 
ls optional. This optional information is indicated inside 
braces { }. In the COPY example above, there is one option: 


{ABS} 


When typing this command, you must decide if you need this 
option which tells TRSDOS-16 to overwrite any existing files 
with the same name. If so, type: 


COPY NEW/DAT:1 TO NEWDAT/1:2 ABS <ENTER> 


You can usually omit the surrounding braces { } unless you 
include a comment or if the second filespec is optional and 
omitted. 


Although the variable "comment" is not included in every 
Syntax statement, you can add one at any time. Comments are 
for your information only. For example: 


COPY NEW/DAT:1 TO NEWDAT/1:2 {ABS} Latest version 
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documents the purpose of the COPY command. 


You might want to use the comment if you are calling the 
command from a DO-file (see the DO command) or a program. 


Every system command uses some variation of the syntaxes 


discussed above. Pay attention to each command to know the 
appropriate parameters and options to use. 
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APPEND 


APPEND source filespec TO destination === 


Copies the contents of the source filespec onto the end of 
the contents of destination. (The contents of the source 
file remain the same.) 


The destination can be a filespec or a drive number. 


If it is a drive number alone, TRSDOS-16 will append only if 
that drive contains a disk file with the same name as the 


source filespec. 


The types of the two files must match, i.e., both must be 
variable length records (VLRs) or both must be fixed length 
records (FLRs). 


You cannot use the APPEND command with ISAM (indexed access 
files used by some Compilers such as the COBOL Compiler) 
files, program files, or TRSDOS-II DO files. 

Example 


APPEND EMPLFILE TO STAFF/LST:3 <ENTER> 


copies the contents of EMPLFILE onto the end of STAFF/LST on 
Drive 3, 


APPEND DOC/NEW:1 TO 2 


copies the contents of DOC/NEW on Drive 1 to the file of the 
same name on Drive 2. 


ATTRIB 
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Assigns or changes the password and protection level of an 
existing filespec. 


Passwords are initially assigned when the file is created. 
At that time, the update and access passwords are set at the 
same value (either the password you specified or a blank 
password). See TRSDOS-16 FILESPECS in Section 1 of this 
manual for further explanation of passwords. 


The options are: 

ACC=password sets the access password to 
password. If omitted, the access password 
remains the same. 

UPD=password sets the update password to 
password. If omitted, The update password 
remains the same. 

PROT=level specifies the protection level for 
access. If omitted, the level is unchanged. 
The optional protection levels for access to a 


file are: 

NONE No access 

EXEC Execute only 

READ Read and execute 

WRITE Read, execute and write 

RENAME Rename, read, execute and write 

KILL Kill, rename, read, execute and write 


(gives access word total access) 


This command allows you to assign a file two passwords. The 
access password could be for the operator. It protects a 
file's contents at a certain protection level (set by PROT). 


For example, if you want an operator to have limited access 
to a file, you can set the PROTection level to READ. Then, 
using the access password, the operator will only be able to 
read and execute the file; not change, rename or kill it. 


In the same manner, the update password could be for the 
programmer. Using the update password, the programmer could 
change, kill, or rename the same file. (When you use the 
update password to access a file, TRSDOS-16 ignores the 
PROTection level.) 


In short, the access password allows limited access to a 
file and the update password allows total access. 


Examples 
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ATTRIB DATAFILE ACC=JUNE19%, UPD=NEWDAT <ENTER> 
sets the access password to JUNE19# and the update password 
to NEWDAT. The PROTection level remains at the previous 
setting. 

ATTRIB PAYFILE ACC= ,PROT=READ <ENTER> 
sets the access password to blanks, leaves the update 


password the same, and sets the level of protection to allow 
only reading and execution of PAYFILE. 


AUTO 


Stores command line. This command line will automatically 
execute whenever you start-up TRSDOS-16. (That is, after 
you enter the date and time, TRSDOS-16 will load, execute 
the command line, and then display the TRSDOS-16 Ready 
prompr., ) 


command line is optional. If you omit it, TRSDOS-16 
deletes the AUTO command line currently stored. 


The system doesn't check the command line for errors when 
you first enter the AUTO command line. Errors are detected 
when the automatic command is actually executed. 

Examples 


AUTO DIR <ENTER> 


executes the DIRectory command whenever you start-up. The 
system then returns to TRSDOS-16 Ready. 


AUTO <ENTER> 
Turns off the AUTO function currently stored. 


AUTO DO MYPROG <ENTER> 
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executes the DO-file named MYPROG. 


BACKUP 


"BACKUP drivel TO drive2 {options} 


(FOR FLOPPY DISKETTE USE ONLY) 
Makes an exact copy of the source diskette in floppy 
drivel to the destination diskette in floppy drive2. 


If the destination diskette is unformatted, the BACKUP 
command will format it before copying the source diskette to 
Lt. 


The options are: 


ID=id assigns the name id to the new diskette. 

If omitted, TRSDOS-16 gives the new diskette the 
same name as the source diskette. 

PW=password indicates the master password of the 
source diskette. TRSDOS-16 won't duplicate a 
diskette unless you give the correct password. 
(All diskettes distributed by Radio Shack use 
PASSWORD as the master password. ) 

NEW=password assigns password to the destination 
diskette. If omitted, TRSDOS-16 uses the password 

| of the source diskette. 

ABS instructs TRSDOS-16 to overwrite the data on the 
destination diskette without prompting. 


To make a backup copy, you need at least two floppy diskette 
drives. If you don't have two floppy drives, use the COPY, 
FCOPY, or MOVE system commands. (See the appropriate 
command for further information. ) 


Unless you have an Enhanced Model II (Model II'sS cannot use 
double-sided diskettes), you can BACKUP a single-sided 
diskette to a double-sided diskette. This gives you twice 
as much disk space. You don't need to tell TRSDOS-16 
whether the diskettes are single-sided or double-sided. 


You cannot BACKUP a double-sided diskette to a single-sided 
diskette. 


If you want to make a copy of a system diskette, BACKUP is 
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the only way to do this. 
Examples 
| 
BACKUP @ TO 1 <ENTER> | 
makes an exact copy of the floppy diskette in Drive @ to the 
floppy diskette in Drive l. 
BACKUP @ TO 3 {ID=MASTER NEW=FEB23} <ENTER> 
duplicates the diskette in Drive @ to the diskette in Drive 
3, naming the new diskette "MASTER" and assigning the master 
password “FEB23” to. it, 
BACKUP 1 TO @ <ENTER> 
allows you to copy a data diskette in Drive 1 to a diskette | 
in Drive @. After entering this command, TRSDOS-16 will | 
prompt you to insert the destination diskette in Drive @. | 
4 s\ CLEAR 
Clears user memory. | 
Example 
CLEAR <ENTER> | 
| 
CLS 
Clears the display and positions the cursor at the top 
left-hand corner of the display. 
i] ® 
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Example 


CLS <ENTER> 


COPY 
COPY source filespec TO destination {option} 


Copies the source filespec to the destination. 


destination can be either a filespec or a drive number. 

If you use a filespec as the destination, you must also 
specify the drive number of the disk containing that file, 
Otherwise, it automatically goes to the primary drive. 


If you specify a drive number only as destination, 
TRSDOS-16 will copy the source file to the disk in that | 
drive, giving the destination file the same name as the | 
source file. | 


The option is: 
ABS tells TRSDOS-16 to overwrite any existing 
file with the same name without prompting 


The source filespec must be a file you can use with 
TRSDOS-16 or TRSDOS-II. If you cannot, you must FCOPY 
rather than COPY it. (See FCOPY for details.) 


You can make single drive copies of a file. If so, be sure 
to assign a different filespec for the destination. 


Example 
COPY OLDFILE:3 TO NEWFILE:4 <ENTER> 


makes a copy of OLDFILE from the diskette in Drive 3 to the 
diskette in Drive 4, naming the new file NEWFILE. 


COPY NEW/DAT TO DEFUNCT/DAT:2 ABS <ENTER> 
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copies NEW/DAT to DEFUNCT/DAT (in Drive 2). If you already 
have a disk file named DEFUNCT/DAT in Drive 2, this command 
overwrites it with the new file. 


COPY NEW/DAT TO 2 <ENTER> 


copies NEW/DAT to the diskette in Drive 2. The newly copied 
file is also named NEW/DAT. 


COPY FILE/BAS:4 TO NEW/BAS:1 <ENTER> 


copies FILE/BAS from the diskette in Drive 4 to the diskette 
in Drive 1, naming the new file NEW/BAS. 


COPY INCTAX/IRS:1 TO INCTAX/82:1 <ENTER> 


copies the file INCTAX/IRS on the diskette in Drive 1 to the 
same diskette, renaming the file INCTAX/82. 


CREATE 


CREATE filespec {options} 


Creates a file named filespec and preallocates space for 
its contents. Without CREATE, TRSDOS-16 allocates space for 
your file dynamically as you write to it. 


The available options are: 

NGRANS=n allocates n X 5 sectors to the file. 
For example, if you want to allocate 1@@ sectors 
to the file, set NGRANS to 2@. 

NRECS=n assigns n fixed length records to the 
file. LRL must accompany NRECS. 

LRL=n assigns n as the logical record length. 
Nn Can bel fo 256. TE DRL 1s somitted, «the 
record length defaults to 256. 

TYPE=t specifies the record type as t. t is 
either F, a fixed length record, or V, a variable 
length record. If TYPE is omitted, t defaults 


LOE. 


NGRANS and NRECS are mutually exclusive. If you use NGRANS, 
don't use NRECS. If you use NRECS, don't use NGRANS. 
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When you use CREATE to preallocate a file, TRSDOS-16 does 
not deallocate unused space at the end of the file. 

Without CREATE, TRSDOS-16 deallocates the unused space upon 
closing the file. 

Examples 


CREATE NAMEFILE NGRANS=459,TYPE=F <ENTER> 


creates a fixed length record file named NAMEFILE with 2259 
sectors. 


CREATE DATMAS/NJ2 NRECS=19@,LRL=2@ <ENTER> 


creates a fixed length record file named DATMAS/NJ2 with 199 
logical records of 29 bytes each. 


CREATE MARKET/WST:3 NGRANS=19@,TYPE=V <ENTER> 


creates a variable length record file on Drive 3 named 
MARKET/WST and allocates 5@@ sectors to it. 


CREATE EMPLY/LST NGRANS=299%,TYPE=F 


creates a 199@ sector fixed length record file on the 
diskette in Drive @. 


DATE 
DATE 


Displays the date and time in the format: 

WED MAR 25 1981 84 -- 16.24.34 
for Wednesday, March 25, 1981, the 84th day of the year, 
4:24:34 p.m. Note that leading zeroes are not shown. 
Example 


AUTO DATE <ENTER> 
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automatically displays the date and time upon startup. 


DIR 


‘DIR source {options} 


TRSDOS-16 OWNER'S MANUAL 


Displays the disk's directory. 


source can be a standard TRSDOS-16 filespec, a wildcard, 


or a drive number 
TRSDOS-16 goes to the first available drive. 


The options are: 
PRT prints the directory listing on the line 


Disk Names TRSDO 


File Name 


DESIGN2 
READ/ME 
TRSDOS146/SYS 
CONF IG16/SYS 
ASM16 

LINK16 
EOITIS 
BOOTIS6 

IFC 

RUNCOBOL /SYS 
VIDTEX 
SAMPLE 1/PRO 
DATM32/ TXT 
DOBUDGET/SRC 
DEMOPROG/ 1 
DIRECAC/FLE. 
MYPROG 


printer. 
SYS displays only the system files 


Shack files). If you don't use the SYS option, 


Saree 
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(certain Radio 


If drive number is omitted, 


TRSDOS-16 displays only the user files. 


Created 
MM/DD/YY 
04/05/82 
04/05/82 
03/26/82 
03/26/82 
02/25/82 
O27 25/02 
03/27/82 
04/03/82 
04/03/82 
03/27/82 
10/13/80 
04/09/82 
04/09/82 
04/09/82 
04/09/82 
04/09/82 
04/09/82 
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CD) 


® © 


Updated 
MM/DD/YY 
04/05/82 
04/05/82 
04/16/82 
04/16/82 
04/14/82 
04/16/82 
04/16/82 
04/16/82 
04/16/82 
04/16/82 
04/07/82 
04/09/82 
04/09/82 
04/09/82 
04/09/82 
04/09/82 
04/09/82 


@ 


Drive:4 


Atrh 


P*X@ 
D*¥X@ 
D*¥X@ 
D¥X@ 
D¥X@ 
D¥X@ 
D¥X@ 
P*X@ 
P#X@ 
D¥X@ 
D#¥X@ 
D¥X@ 
D#¥X@ 
D*¥XB 
D¥XB 
D¥XQ 
D¥X@ 


af 


ras 


= 


Qe <c ccc TATA AAA TAKS TATA THeA 


4 
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04/09/82 
Rec # oof 
Ler Recards 
256 z£ 
Zo6 fay 3 
256 187 
+++ bt 
236 148 
206 &4 
£00 5@ 
256 & 
255 Ls 
256 6B 
1 eet 
+44 ttt 
++ +++ 
+44 tf 
++ +44 
+++ + 
+++ +++ 
@ ® 


QA.29.16 


Mon Se CO re Aes 


Allac 


Pa 3 
107 

1 
148 


Used 


7? 
107 
1 
146 
64 
5 
& 
15 
68 
tol 
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What the column headings mean: 


Ol & W 


Disk Name -- The name assigned to the disk when it 
was formatted or backed-up. 
File Name -- The name and extension assigned to a 
file when it was created. 
Creation Date -- When the file was created. 
Update -- When the file was last modified. 
Attributes -- A four-character field. 
The first character is either P for Program file 
or D for Data--file. 
The second character is either S for System file 
or * for User file. 
The third character gives the password 
protection status. 
X The file is unprotected (no passwords) 
A The file has an access word but no update 


word. 

U The file has an update word but no access 
word. 

B The file has both update and access 
words. 


The fourth character specifies the level of 
access assigned to the access word: 

0,l Kill file and everything listed below. 
Rename file and everything listed below. 
Not used. 

Write and everything listed below. 

Read and everything listed below. 
Execute only. 

None. 

The ATTRIB command explains how to change the 
access password, update password, and protection 
level. 

File Type -- Indicates the record type for the 
file. 

F Fixed-length records. 

V Variable-length records. 

Record Length -- Assigned when the file was 
created (applies to fixed-length record files 
OnLy) 

Number of Records -- How many logical records have 
been written. Plus signs (+) signify none have 
been written or file has variable length records 
and number written cannot be calculated. True 
number of records can be inferred from Sectors 
Used column. 


“J OV Ol Bm W ND 
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9 Sectors Allocated -- How many sectors (256 byte 
blocks) have been allocated to the file. 

19 Sectors Used -- Shows how many sectors have data 
written into them. Plus sign (+) means no data in 
EL, 

cm. Files Displayed -- the number of files on the 


DIRectory listing. 


Figure 1. Sample DIRectory Display 


Examples 
DIR BAST/ASM <ENTER> 

lists the directory for the file BAST/ASM on the display. 
DIR 3 PRT <ENTER> 


lists the directory of the diskette in Drive 3 to the line 
printer. 


DIR B*/* <ENTER> 


displays all files in the directory beginning with the 
letter B and having an extension. 


DISMOUNT 
DISMOUNT 


Tells TRSDOS-16 that you have removed diskettes in the 
floppy drives. 


The DISMOUNT command informs TRSDOS-16 that you have just 
taken diskettes out of the drives. Once you enter the 
DISMOUNT commmand and TRSDOS-16 acknowledges, you can insert 
different diskettes. See MOUNT for details. 


Example 


DISMOUNT <ENTER> 
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informs TRSDOS-16 that you have removed diskettes from the 
Floppy drives. TRSDOS-16 acknowledges the DISMOUNT by 
displaying: 

INIT DONE 


Now you can insert other diskettes. 


DO 


ee te 
Executes a "DO-file" -- a file containing one or more system 
commands or programs. 


You can create this DO-file with the Editor. The example 
below shows how. 


A DO-file cannot include the SPOOL command. You can load 
and execute programs from a DO-file and chain DO-files 
together. 


Example 


This example creates a sample DO-file that prints the 
current date and amount of free sectors on the disk in the 
primary drive whenever you execute it. 


You need to use the Editor to create this file. Type: 
EDITL6 <ENTER> 


to get into the Editor. The C? prompt is displayed, 
Signifying the Editor's command level. 


To begin writing your program, type: 
IN <ENTER> 


This puts you in the insert mode, with the prompt I?. You 
can begin entering command lines. Type: 


DATE <ENTER> 
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FREE <ENTER> 


These are your command lines. Now save this DO-file under 
the name HELLO. But first, exit the insert mode. Type: 


<EN TER> 

and then, to save the file, type: 
SA HELLO <ENTER> 

Exit the Editor by typing: 
QU <ENTER> 


and you can run your DO-file, listed on your directory as 
HELLO. ‘Type: 


DO HELLO <ENTER> 


and TRSDOS-16 executes the DO-file named HELLO and prints 
the date and free list on your display (see the DATE and 
FREE commands). 


DRIVE 


DRIVE drive {options} 


Allows you to: 


ae Gain optimum use of a floppy disk drive by 
changing the following disk drive settings: 
‘ seek rate (the rate the computer is able to 
access the diskette) 
: diskette swap detection 
. wait (for a drive ready condition) 
Li Turn secondary floppy or hard disk drives offline. 


If you include no options, DRIVE returns the current 
settings for the specified drive. 
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The following information offers a thorough explanation of 
the DRIVE command and all its options. Please read it 
before using this command. 


The options are: 
RATE=n (used for floppy drives only.) Sets the seek 


DETECT 


NODETECT 


WAIT 


NOWAIT 


OFFLINE 


ONLINE 


rate of the floppy disk drive. n may be: 

3 milliseconds 

6 milliseconds 

1@ milliseconds 

15 milliseconds 

If omitted, setting is not changed. 

(used for floppy drives only.) Sets the 
diskette swap detection. This causes 
TRSDOS-16 to check the drive hardware for a 
"door opened" condition. Set DETECT for 
Push-Button and Thinline drives. 

(used for floppy drives only.) Sets the 
diskette swap to "no detection". This causes 
TRSDOS-16 to ignore any "door opened" 
conditions received from the drive hardware. 
Set the latch drives for NODETECT. 

(used for floppy drives only.) Sets 
TRSDOS-16 to wait for the drive to gain 
proper motor speed if a "Drive Not Ready" 
error occurs, then try again. If the error 
occurs again, then the drive is considered 
not ready and an error code is generated. Set 
WAIT for Thinline drives. 

(used for floppy drives only.) Sets TRSDOS-16 
to not wait if a "Drive Not Ready" error 
occurs. Generate error code immediately. Set 
Push-Button and Latch Drives to NOWAIT. 

(all secondary drives) Sets a drive offline. 
TRSDOS-16 ignores that drive entirely. 

(all secondary drives) Sets a drive online. 


WhOrFHS 
touu d 


1. GAINING OPTIMUM USE OF FLOPPY DISK DRIVES 


When TRSDOS-16 starts up, it initializes each of your floppy 
drives to the following seek, swap, and wait/nowait 


settings: 
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SEEK SWAP WAIT /NOWAIT 
DRIVE RATE DETECT STATUS 
g 1% ms DETECT WAIT 
ica 3 15 ms NODETECT WAIT 


All floppy drives can operate under these settings. 
However, to get the optimum use out of your particular 
drive, we suggest you try different settings. 


There are three types of drives that could be on your 
computer. Each type of drive has its own set of 
specifications that determines how it can be set-up. 


The three types of drives are: Push-Button, Latch, and 
Thinline. 


We suggest you try the following settings for each of these 


drives. 

ree oe  <. e.. 
a Drive Rate Detect NOWALE aS 

Push-Button 1% ms DETECT NOWAIT 

Latch =——i<id‘Sms® CS NODETECT* NOWAIT 

Thinline = 3s sO#DETECT. «=—WAIT# 


SS A ED ED ED EY CORED CGD GED ATR AON ED ED ED AED ED SD SUE ce ee ee eee eee ees sue 


A A 1 ED EE ES EE ED SED SD ES MED “SD OE ED wereED 
cama 


L222 AAS LS A AS A A A AS A A A AE NE AE EE SR EE ED RED ED ED ne cee NEED NOE GD SORE SORE SOD me ee eA oe NGS ee ED OED ED Ao ED OD eee <a GED WD eee Vee <<a 


* These settings are required for these particular 
drives and are set this way at start-up. 


You can determine the type of drive you have by looking at 
the pictures on the next page. 
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Push-Button Latch Thinline 


Figure 2. The three types of drives 


When using the DRIVE command with the seek rate, swap 
detect, and wait options, be sure to note the following: 


‘ When reset, TRSDOS-16 always returns to the start-up 
settings. Use the AUTO command (or a DO file) to 
implement the DRIVE command automatically upon power-up 
or reset. 


; If you receive numerous I/O errors on disk reads/writes 
after changing the seek rate, you probably set it too 
fast for that particular drive. To remedy this, either 
issue the DRIVE command again with the proper seek 
rate or reset the computer. 


‘ Latch drives cannot properly detect if a drive door 


has been opened since the last disk access. Always set 
Latch drives with the NODETECT option. 
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‘ Thinline drives have a built in feature to reduce the 
wear on the floppy diskette. If a Thinline drive is 
not accessed for 28 seconds or more, the drive motor 
shuts off until the next drive access. At the next 
disk access, it takes approximately 8/1 of a second 
for the motor to reach proper speed. 


Always set Thinline Drives with the WAIT option. Le 
a Thinline Drive is run with the NOWAIT option, a 
"Drive Not Ready" error will occur since the motor 
could not reach proper speed before the access. 


Examples 
If your Drive @ is a Thinline drive, this command: 
DRIVE @ {RATE=§,DETECT,WAIT} <ENTER> 
allows you to get the optimum use out of Drive @. 
If your drive is Push-Button, this command: 
DRIVE 1 {RATE=2,DETECT,NOWAIT} <ENTER> 
allows you to get the optimum use out of Drive l. 
If your drive is a Latch, this command: 
DRIVE 1 {RATE=3,NODETECT,NOWAIT} <ENTER> 


allows you to get the optimum use out of Drive l. 


2. TURNING THE DRIVES OFFLINE 


The OFFLINE option turns a secondary disk drive OFFLIINE; 
ONLINE turns it back ONLINE. You can use both options with 
both hard or floppy secondary disk drives: 


‘ Floppy Drives -- By turning a non-existing or 
unused secondary floppy drive OFFLINE, TRSDOS-16 
will access your disks much more quickly. 

‘ Hard Disk Drives -- If you have more than one hard 
disk drive, you can MOVE or COPY files to your 
secondary drive(s), turn these drives OFFLINE, and 
thus protect your files from access and/or change. 
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The default is ONLINE. When you turn a drive back ONLINE 
after it was OFFLINE, you must also use the MOUNT command to 
reinitialize the drive. 


Example 
DRIVE 5 {OFFLINE} <ENTER> 

allows you to protect files on Drive 5 from access. 
DRIVE 3 {OFFLINE} <ENTER> 


allows you to tell TRSDOS-16 not to attempt to access Drive 
3; this speeds up access time. 


DRIVE 2 {ONLINE} <ENTER> 
tells TRSDOS-16 to attempt to access Drive 2. 


Tf you have a Hard Disk, you might find it helpful to create 
a DO-file (see DO command) containing these commands: 


DRIVE 6 {ONLINE} 
MOVE !:5 TO 6 {ABS} 
DRIVE 6 {OFFLINE} 


This will cause TRSDOS-16 to turn Drive 6 ONLINE, MOVE all 
the files on Drive 5 to Drive 6 and then turn Drive 6 back 
OFFLINE. 


DUMP 


DUMP filespec {options} 


Copies filespec, a machine-language program, from memory 
to disk. You can then load and execute the program from 
TRSDOS-16 Ready. 


The options can be any or all of the following: 
START=address sets address as the program's 
starting address. 
END=address sets address as the program's ending 
address. 
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TRA=address sets address as the transfer address. 
This is the address where your program begins 
executing after you load it. If omitted, DUMP uses 
the address set by RELO. The transfer address 
must be less than the ending address. 

RELO=address sets address as the starting address 
for loading the program back into memory. If 
omitted, START is used. 

RORT=c specifies the program as c, directly 
executable from TRSDOS-16 Ready mode. c can be: 
R(eturn) loads filespec, but doesn't execute it. 
T(ransfer) loads and executes filespec from 

TRSDOS-16 Ready. If omitted, RORT=T is used. 


NOTE: All addresses are 24-bit hexadecimal numbers (up 
to Six Digits). 


Examples 


DUMP TEST/FIL START=64F0, END=6AF0, TRA=67F2, RORT=R <ENTER> 


creates filespec TEST/FIL which contains the program in 
memory location 64F0 hex to 6AFO hex. When loaded, it 
occupies the same memory location. Since this specifies 
RORT=R, you can't execute the program from TRSDOS-16 Ready 
mode. 


DUMP INTCOM/DMA START=6000, END=67FF, TRA=3108, RELO=3000 <ENTER> 
creates filespec INTCOM/DMA. It contains the program in 

memory location 6000 hex to 67FF hex. When loaded, the 

program resides from 3000 to 37FF and execution starts at 

3108 hex. You can execute the program from the TRSDOS-16 

Ready mode by typing: 


INTCOM/DMA <ENTER> 


EXEC 


EXEC filespec 


Executes a machine language program named filespec. 
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The keyword EXEC is optional. 


Examples 
EXEC JOBLIST <ENTER> 
executes JOBLIST. 
NAMEDUMP <ENTER> 


executes the program NAMEDUMP. 


FCOPY 
FCOPY source TO destination {options} 


Copies disk files that were created with the TRSDOS 
Operating System to a disk formatted by TRSDOS-16 (or 
TRSDOS-II) and vice versa. 


You must FCOPY any disk files created with TRSDOS before you 
can use them with TRSDOS-16 or TRSDOS-II. You will get the 
error -- Illegal I/O Attempt -- if you attempt to uSe a 
TRSDOS diskette while operating under TRSDOS-16. 


source can be a filespec, wildcard, or drive that you want 
LO CODY. 


destination can be the drive number that you are FCOPYing 
to or the filespec you are FCOPYing to. destination can 
be a filespec only if source is a filespec. 


options can be one of the following: 

ABS tells TRSDOS-16 to overwrite any data that 
already exists on the disk 

PROMPT tells TRSDOS-16 to prompt you before it copies 
a file. You should press <Y> yes, <N> no, <Q> 
quit, or <S> stop asking for prompting. 

ALL tells TRSDOS-16 to copy all files. (ALL won't 
transfer system files, use SYS.) If you use 
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drive alone as source, you must use ALL. 

SYS allows you to FCOPY language and applicaton 
programs. If used, destination must be primary 
drive. 


In addition to using FCOPY to copy disk files and change 
their format, you can use FCOPY to get a DIRectory listing 
of your TRSDOS files while you are in the control of 
TRSDOS-16. 


The syntax is: 
FCOPY drive {DIR,SYS, PRT} 


When you use the FCOPY command with DIR and SYS, TRSDOS-16 
will return the DIRectory according to the way the diskette 
in drive is formatted. For example, if you enter the 
command: 


FCOPY 1 41 DIR;SYS} <ENTER> 


and the diskette in Drive 1 is in TRSDOS 2.@A format, it 
will return a directory consisting of both System and User 
files. 


On the other hand, if you use the same command on a diskette 
formatted under TRSDOS-II, it will return a DIRectory of 
only the System files. 


Examples 

FCOPY NEWFILE/TXT TO :3 <ENTER> 
copies NEWFILE/TXT (contained on a TRSDOS-formatted 
diskette) to the diskette in Drive 3 (a TRSDOS-16 formatted 
diskette). 

FCOPY 1 TO @ {ALL} <ENTER> 


copies all files on the TRSDOS-formatted diskette in Drive l 
to the TRSDOS-16 formatted diskette in Drive @. 


FCOPY } TO 1. <ENTER> 
copies all files, with and without extensions, from the disk 


in the primary drive to Drive 1. (See "Wildcards" in Section 
243 
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FCOPY TRN/TXT:1 TO TRNTXT/OLD:4 <ENTER> 


copies the file TRN/TXT on the diskette in Drive 1 to the 
disk in Drive 4, renaming the file TRNTXT/OLD as it copies 
and reformats. 


FCOPY 2 {DIR} <ENTER> 


lists the DIRectory of the TRSDOS diskette in Drive 2. 


FILES 
FILES source {options} 


Returns an alphabetical listing of the filenames that are 
stored on the specified source. 


source can be a standard TRSDOS-16 filespec, a wildcard, 
or a drive number (0-7). If drive number is omitted, 
TRSDOS-16 goes to the primary drive. 


The options are: 
SYS lists all system files. SYS is optional; if 


omitted, TRSDOS-16 lists only the user files. 

PRT tells TRSDOS-16 to print the files. PRT is 
optional; if omitted, lists files on the video 
display. 


This command will list filenames that are stored on the 
specified drive. This is not the same as DIRectory because 
only filenames are listed with FILES. FILES lists the 
filenames alphabetically in five columns (from left to 
right) across the screen. 


FILES allows full wildcarding. For details, see Section I 
of this manual. 


Example 


FILES */BAS:4 {PRT} <ENTER> 
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lists all files with the extension /BAS on Drive 4 to the 
printer. | 


FILES 0 {SYS} <ENTER> 


lists all System files on Drive 0. The System directory is 
on Drive 0. 


FLOPPY 
FLOPPY {options} 


Tells TRSDOS-16 to ignore all references to floppy drive 
numbers within filespecs. This is useful when a program 
includes a reference to a file specification where a drive 
number is included. 


options are: 


ON sets FLOPPY ON. TRSDOS-16 does not ignore 
references to drive number within filespecs. 
OFF sets FLOPPY OFF. TRSDOS-16 ignores any 


references to drive number within filespecs. 


If you do not specify option, TRSDOS-16 displays the 
current status of FLOPPY. 


When you enter FLOPPY OFF, TRSDOS-16 ignores any reference 
to a floppy drive number (0-3) within a system command or 

program and follows the normal file search sequence (going 
to the primary drive first). 


For example, assume a COBOL program references a file named 
SAMPLE:2. By turning FLOPPY OFF, TRSDOS-16 will treat this 
reference as simply SAMPLE (ignoring the drive reference) 
and look for it on the primary drive first. 


The system commands which require a filespec and are 
affected by FLOPPY are: 


ATTRIB DO LOAD 
APPEND DUMP MOVE 
COPY KILL OPEN 
CREATE LIST RENAME 
® 
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Examples 
FLOPPY {OFF} <ENTER> 


sets FLOPPY OFF so that TRSDOS-16 ignores any references to 
drive numbers within a filespec entered with a system 
command or program. 


FLOPPY {ON} <ENTER> 


turns FLOPPY ON so that TRSDOS-16 uses the drive number 
referenced in any filespec. 


FLOPPY <ENTER> 


returns the status of FLOPPY. 


FORMAT 
FORMAT drive {options} 


Prepares a blank disk for use by defining the tracks and 


sectors, and writing system information onto it. (For more 
information, see TECHNICAL INFORMATION. ) 


drive specifies the drive to use for the format operation 
and can be Drives @ - 3 and 5 - 7. If omitted, TRSDOS-16 
prompts you to enter the drive number. 


The options are: 

ABS tells TRSDOS-16 to overwrite existing data 
without prompting. If omitted, TRSDOS-16 warns 
you before overwriting a disk that contains data. 

ID=id assigns a name to the disk being formatted. 

If omitted, TRSDOS is used. 

PW=pw assigns the master password to the disk. If 
omitted, PASSWORD is used. The master password 
allows access to all user files (via the PROT 
command), and also allows full BACKUP privileges. 

DIR=nn places the primary directory on cylinder 
nn. If omitted, TRSDOS-16 uses cylinder 44, 
(Single-sided and double-sided floppy); or 
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cylinder 138 (hard disk). You can put the primary 
directory on any cylinder from 1 - 71 
(single-sided or double-sided floppy); or 1 - 253 
(hard disk). 

ALT=nn places the alternate directory on cylinder 
nn, which is a backup of the primary directory. 

If ALT=$9, no alternate directory is created. If 
you omit the ALT option, it will be at the 
location of the primary directory plus 3 cylinders 
(single-sided and double-sided floppy, or hard 
disk). You can put the alternate directory on 
cylinders 1 - 71 (single- or double-sided floppy); 
or l= 253 (hard-disk), 

SIZ=nn tells TRSDOS-16 to allow nn filenames in 
the initial directory. For hard disks and floppy 
diskettes, nn can be any number between 
11-1228. If omitted, the default is 189 
(Ssingle- or double-sided floppy); or 336 (hard 
disks). 

FULL/NONE is the verification level. FULL instructs 
TRSDOS-16 to read each sector and compare the 
value against what was written during 
initialization. NONE instructs TRSDOS-16 not to 
oerform verification. 


The disk you format can be blank or already formatted. If 
it is already formatted, all information is lost when you 
reformat the disk. 


Examples 


FORMAT 1 {ID=ACCOUNTS,PW=IRS} <ENTER> 


formats the diskette in Drive 1 and names the diskette 
ACCOUNTS with the password IRS. 


FORMAT <ENTER> 


prompts you for the drive to use before it begins to format. 
Since no options are used, the diskette will have the name 
TRSDOS, the password PASSWORD and all the other option 
defaults. 


FORMAT 2 {DIR=@1,ALT=95,S1IZ=360} <ENTER> 
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formats the diskette in Drive 2, puts the primary directory 
on cylinder 1, the alternate directory on cylinder 5 and 
sets the number of directory records to 360. 


WHEN TO FORMAT 


To prepare a new disk 
Before you can use a new diskette, you must format it 


(unless you use the BACKUP command with a floppy diskette). 
After formatting, record the disk name, date of creation and 
password in a safe place. This helps you estimate how long 
a disk has been in use, and prevents your forgetting the 
master password. (For this application, always use the FULL 
verify option.) 


To erase all data from a disk 

To "Start over" with a disk, you can format it. This erases 
all old information on the disk and puts the system 
information back on it. 


To lock out flawed areas 

After prolonged use, flaws may develop on a diskette. If 
you reformat the disk, it locks out these flawed sectors 
while leaving the good sectors available for data storage. 
Use the FULL verify option for this application. 


FORMS 


FORMS {format options} 
FORMS {switch options} 


Sets up the printer parameters. 


The {format options} are: 

P=n sets n as number of lines per page. n can 
be any number between 0 and 255. If omitted, it 
is 66. 

L=n sets n as the maximum number of lines to 
print on a page before issuing an automatic top of 
form. n can be 0 to 255 and, if omitted, L=60. 
The number of lines must be less than or equal to 
the page length. If either page length or lines 
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is @, both must be @. If L=9, TRSDOS-16 doesn't 
issue an automatic top of form. 

W=n sets n as the maximum number of characters to 
print on a line before issuing an automatic 
carriage return. n can be any number between 9 
and 255. If omitted, W=132. 

Tf W=9, TRSDOS-16 doesn't issue any automatic 
carriage returns. 

C=h sets the output to h, a one-byte control code 
in hexadecimal, to the printer. It is sent on 
completion of FORMS command. 


The default parameters are P=66, L=6@, W=132 and c=@. If 
you want to use the default parameters, you don't need to 
issue the FORMS command. 


To determine the parameters to set for: 


page size multiply form length in inches by the number 
of lines per inch. 

lines determimes the number of blank lines at the 

per page bottom of every page. If page length equals 
lines, then every line on the page is 
printed. lines can't be greater than page 
length. width sets the maximum number of 
printable characters per line. If a line is 
greater than width, then TRSDOS-16 
automatically breaks the line at the maximum 
length and continues printing at the next 
print Jane. 

control are required on some printers, e.g. to set 

codes up for double space character, etc. The 
TRSDOS-16 sends the specified code to the 
printer or print file during execution of 
the FORMS command. 


The {switch options} are: 
Xx sends all data to printer or printer file without 


any translation (transparent mode). 

D ignores all printer output ("dummy" mode). 

N returns to normal (nontransparent, non-dummy ) 
mode. This is the default mode. 

A outputs line feed after carriage return (auto line 
feed mode) even if transparent mode is in effect. 
Updates count by carriage returns, not by line 
feeds. 
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si sends top of form character to printer. 

Q cancels auto line feed mode. 

S switches to serial Channel B printer driver. (You 
must do SETCOM before any printing can be done.) 

R returns to parallel printer driver. 


See the PRCTRL Supervisor Call in the Technical Information 
Section for information on transparent, dummy modes, etc. 
Examples 

FORMS <ENTER> 
resets all FORMS parameters to the default values. 

FORMS P=5l1, L=46, W=92 <ENTER> 


sets page length to 51, printed lines per page to 46 and 
characters per line to 92. 


FORMS D <ENTER> 


invokes the dummy mode. This means TRSDOS-16 will ignore 
all printer commands. 


FREE 


FREE drive {option} 


Returns a list of the disk's free sectors. 


drive is optional; if omitted, it defaults to the primary 
drive. 


The option is: 
PRT prints the listing on the Printer. If omitted, 


TRSDOS-16 automatically displays it on the video 
display. 


This information is useful to optimize file access time. 
If you use a disk extensively (files updated, killed, 
extended, etc.), the files often become fragmented. This 
means that the file may be put in different parts of the 
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disk's memory -- extents. When this happens, the access 
time is considerably increased because the disk read/write 
mechanism must move back and forth across the disk to read 
or write to a file. 


FREE helps you determine the extent that your disk files are 
fragmented. Once you determine this and you decide that 
you'd like to re-organize a particular file to allow faster 
access, you can COPY or MOVE it to a "clean" diskette. 


FREE LIST far Drive:4 Disk Name: TRSDOS 
& es 16587 34 16592 ——. © 
Soe 52 Free Sectars in 5 Extents 


@ ©) 


I Drive Number 
2 Disk Name 
3 Number of FREE sectors in each extent 
4 Total number of free sectors 
5 Number of FREE extents (an extent is an area on the 
disk) 
Figure 3. FREE List 
Example 


FREE <ENTER> 


displays the amount of free space on the disk in the primary 
drive. 


FREE {PRT} <ENTER> 
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lists the amount of free space for the primary drive to the 
printer. Because no drive specification is included in this 
example, you must use the braces, { }. 

FREE 2 PRT <ENTER> 


lists the free space for Drive 2 to the printer. 


HELP 
HELP command 


Displays the syntax of a TRSDOS-16 command. command is 
optional; if you omit it or type an unrecognized command, 
TRSDOS-16 displays the TRSDOS-II and TRSDOS-16 commands and 
general subjects for which HELP is available. 
Example 

HELP MOVE <ENTER> 
displays the syntax for the MOVE command. 

HELP SYNTAX <ENTERD> 


returns an explanation of the format of the HELP messages. 


KILL 
KILL filespec 
Deletes filespec from the directory and frees the space 
allocated to it. 
Before it deletes the file, TRSDOS-16 displays the complete 


Filespec and prompts you with the options "Delete? 
(YINZO) su po 2 Sp ess NGY Or OULe, 
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Example 
KILL DATAFILE/OLD <ENTER> 


deletes DATAFILE/OLD from the directory and frees all space 
allocated to it. 


LIB 


LIB 


Displays a listing of all system commands. 
Example 


LIB <ENTER> 


LIST 


LIST filespec {options} 


Lists the contents of filespec. This listing shows the 
hexadecimal contents and the ASCII characters corresponding 
to each value. For values outside the range of hexadecimal 
26 to 7F, TRSDOS-16 displays a period. 


The options are: 
PRT lists filespec to the printer. If omitted, the 


listing automatically goes to the screen. 

SLOW tells TRSDOS-16 to pause after each record. If 
omitted, the listing is continuous. 

R=n sets the starting record to n. The range for 
nis 1 to 65,535. If omitted, 1 is used. (See 
TECHNICAL INFORMATION for details.) 

A tells TRSDOS-16 to list only the ASCII 

characters. 


Examples 
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LIST DATA/BAS <ENTER> 

lists the contents of DATA/BAS. 
LIST TEXTFILE/1 SLOW <ENTER> 

lists the contents of TEXTFILE/1, pausing after each record. 
LIST TEXTFILE/1 R=199, A <ENTER> 


lists TEXTFILE/1 starting with the 19@th record in it. Only 
ASCII characters are displayed. 


LIST PROGRAM/CMD PRT <ENTER> 


lists PROGRAM/CMD to the printer. 


LOAD 


LOAD filespec 


Loads a machine language program named filespec and then 
returns to the TRSDOS-16 mode. 


Example 
LOAD MARKET/OBJ <ENTER> 


loads the machine language program file named MARKET/OBJ 
into memory. 
MOUNT 

MOUNT 


Tells TRSDOS-16 that you have inserted different diskettes 
in the floppy disk drives. 
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Whenever you swap diskettes, you must tell TRSDOS-16 that 
you have done so -- both before removing the old diskettes 
and after inserting the new diskettes. (Be sure not to 
remove a diskette when a file is open.) 


See the DISMOUNT system command for instructions on removing 
diskettes. 


Example 
MOUNT <ENTER> 


informs TRSDOS-16 that you have inserted different diskettes 
in the floppy drives. 


TRSDOS-16 will acknowledge the MOUNT by displaying: 


INIT DONE 


MOVE 
MOVE source TO destination {options} 


Copies single or multiple user files to the destination 
disk. 


source can be a filespec, a wildcard (* or !), or simply a 
drive number. However, you cannot move password protected 
files. 


When you specify only drive as the source, TRSDOS-16 moves 
all user files on the disk in that drive to the destination 
drive. 


destination is the drive number of the disk where you want 
your file(s) moved. Your MOVEd files will retain the same 
name as the source filespec. 


options are: 
ABS instructs TRSDOS-16 to overwrite any existing 


files on the destination disk that have the 
same name. 

PROMPT tells TRSDOS-16 to display each file before 
moving it and to give you a set of options for 
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that file. The PROMPT options are: Y/N/S/Q 
(Yes--Copy;No--Don't Copy;Stop prompts and proceed 
with all copies;Quit this command--no more 
copies.) If PROMPT is omitted, TRSDOS-16 moves 
all files that match the wildcard specification. 
ALL tells TRSDOS-16 to move all user files. This 
parameter is required when you move all files 
(except the system files) on a disk. 


MOVE is useful when you want to copy all of your TRSDOS-16 
files from floppy diskette to hard disk, or vice versa. 
Because it moves only the user files (those files which you 
create), you need to use the COPY command to move your 
system files (your Radio Shack files, such as the Editor, or 
the Assembler). 


For example, type: 
MOVE @ TO 4 {ALL} <ENTER> 


to move all your user files from the diskette in Drive @ to 
hard disk. 


Then, use the COPY command to copy each of your system files 
to your hard disk. 
Examples 

MOVE DAT/FLE:1 TO 3 <ENTER> 


moves the file DAT/FLE on the diskette in Drive 1 to the 
diskette in Drive 3, keeping the filename DAT/FLE. 


MOVE */PAY TO 2 <ENTER> 


copies all user files with the extension /PAY on the disk in 
the primary drive to the diskette in Drive 2. 


MOVE ! TO 3 <ENTER> 


moves all user files, with and without extensions, on the 
primary drive to the diskette in Drive 3. 


MSG 


Radie Shaek 


62 


TRSDOS-16 OWNER'S MANUAL > TRSDOS-16 SYSTEM COMMANDS 
TRS-8O 


MSG "message" 


Prints message on the screen. You must enclose the 
message in quotes. 


This command is especially useful in a DO-file. (See DO for 
more information.) 


Example 
MSG "THIS PROGRAM REQUIRES ONE DATA DISKETTE" <ENTER> 


prints THIS PROGRAM REQUIRES ONE DATA DISKETTE on the 
screen. 


PATCH 


PATCH filespec {options} 


Allows you to make minor corrections in any disk file, 
provided that: 


1. You know the existing contents and location of the 
data you want to change. 
2. You want to replace one string of code or data 


with another string of the same length. 
3. The file is a fixed-length record (FLR) file. 


filespec indicates the file you want to change. If it is 
a system file, no password is necessary. 


The options are: 
A=aaaa indicates the starting address of the data to 


be changed. This is where the data resides in 
memory when the program is loaded. aaaa is a 
four-digit hexadecimal value without the xX'' 
notation. (The A option will not work on 68000 
programs. Use the R and B options instead.) 

F=findstring indicates the string that is currently 
in the patch area. 
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C=changestring indicates what data will replace 
findstring. changestring must contain the 
Same number of bytes as findstring 

R=record tells which record contains the data to be 
changed, and is a decimal number from 1 to 65536. 

B=starting byte specifies the position of the first 
byte to be changed. It is a decimal number from l 
tO 256. 


You can use PATCH to make minor changes to your own 
machine-language programs; you won't have to change the 
source code, reassemble it, and recreate the file. You can 
also use it to make minor replacement changes in data files. 


PATCH also allows you to implement any modification to 
TRSDOS-16 that may be supplied by Radio Shack. This way, 
you do not have to wait for a later release of the operating 
system. 


NOTE: If you press <BREAK> during a PATCH operation, 

before any changes have been made in the file, PATCH will 
close the file and return to TRSDOS-16. The file will be 
unchanged. Once the PATCH process begins, <BREAK> will have 
no effect. 


USING PATCH ON A TRSDOS-16 SYSTEM FILE 


When Radio Shack releases a modification to TRSDOS-16, you 
will receive a printout of the exact PATCH commands that you 
must enter to perform the change. 


To implement such a change, follow these steps: 


1. Make a backup copy of the diskette to be patched. 
2. Insert the TRSDOS-16 diskette to be changed into one of 


the drives. (Make sure the diskette is "non-write- 
protected. ) 

3. In the TRSDOS-16 Ready mode, type in the specified PATCH 
command. 


4. After the PATCH is complete, test the diskette in Drive 
@ to see that it is operating as a TRSDOS-16 system 
diskette. You will have to reset the Computer. 


USING PATCH ON A Z-88 PROGRAM FILE 
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In this context, "program files" refers strictly to those 
files stored with the "P" attribute. Use the DIR command to 
Find out the attributes of a file. BASIC programs have the 
"D", not the "P", attribute. (See instrucitons for changing 
data files.) Program files are created with DUMP. 


If you want to change four bytes in a machine-language 
program file, you must first determine where the four-byte 
sequence resides in RAM when the program is loaded. Next 
make sure that your replacement string is the same length as 
that of the original string. For example, you might write 
down the information as follows: 


Files to be changed: VDREAD 

Start address: H'5289@' 

Sequence of code to be changed: H'CD2C25E5' 
Replacement code: H'@G@ssAGc9d' 


Then you could use the following command: 


PATCH VDREAD A=5289,F=CD2C25E5,C=6GGOGGC9I 


USING PATCH ON 68$%@ PROGRAM FILES AND DATA FILES (INCLUDING 
BASIC AND COBOL PROGRAMS ) 


If you want to patch a 6899M program file or if you have a 
File stored with the "D" attribute, you must specify the 
patch area in terms of the logical record which contains the 
data, and the starting byte of the data record. (The 
TRSDOS-16 LIST command gives this information. ) 


For example, if you want to change a 12-byte sequence in a 
file called NAMEFILE, use the LIST command to find the 
location of the sequence. If it is in Record 128, starting 
at byte 14, write down the information like this: 


File to be change: NAMEFILE 

Record number: 128 

Starting byte: 14 

Sequence of text to be changed: "JOHN'S DINER" 
Replacement text: "JACK'S PLACE" 


Then use the following command to patch a data file: 


PATCH NAMEFILE R=128,B=14,F="JOHN'S DINER",C="JACK'S PLACE" 
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For data files, notice that either string can include a 
single-quote, as long as the string is surrounded by 
double-quotes. If you want to include a double-quote inside 
either string, you would have to enclose that string in 
single-quotes. 


Use this command to patch a 688@@ program file: 

PATCH BUDGET/PRO R=24,B=8,F=FDCB#9,C=C38129 
NOTE: The string you change must be entirely contained 
inside the specified record. If it spans two records, you 
will have to perform the patch operation twice, once for 
each record. 
ERROR CONDITIONS 
If a TRSDOS-16 error occurs during the patch operation, you 
will receive the appropriate error message, and the patch 


will be terminated without changing the file. 


PATCH can also produce the following messages: 


PATCH STRING TOO LONG -- ABORT This occurs when you 
patch a data file and the patch string spans two 
records. You need to perform the patch in two 


steps, one for each record that contains a part of 
the string to be changed. 


FILE CONTAINS VARIABLE-LENGTH RECORDS -- ABORT You 
can only patch fixed length record files. 


STRING NOT FOUND The findstring was not 
found at the patch location you specified. Before 
patching a file, you must know the exact patch 
location and the existing contents of that 
location. 


ADDRESS OUT OF PROGRAM-LOAD RANGE -- ABORT This 
occurs when you attempt to patch a program file 
and some or all of the patch string is outside the 
RAM area where the program resides when it is 
loaded. Check the A=aaaa parameter. Also be sure 


that the findstring and changestring are not 
longer than you intend them to be. 
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PAUSE 


PAUSE prompt message 


Prints prompt message and then waits for the operator to 
press <ENTER>. (The prompt message is optional.) 


Like MSG, this command is especially useful in a DO-file. 
(See DO for more information. ) 
Example 

PAUSE INSERT DISKETTE "SALESRPT" INTO DRIVE 2 <ENTERD>D 
prints PAUSE INSERT DISKETTE "SALESRPT" INTO DRIVE 2, Press 


any key to continue, then pauses until the operator presses 
a key. 


PRINT 


PRINT filespec {options} 


Prints out contents of filespec, omitting the record 
numbers and hexadecimal codes (LIST does that). filespec 
must be a text file. 


The options are: 
A causes TRSDOS-16 to treat the first byte in each 


record as a FORMS control character. The meaning 
of the character in the first byte is: 


gir do a form feed before printing (top of 
form): 

so do a carriage return before printing (single 
space) 

=p" perform two carriage returns before printing 
(double space). 

ad perform a carriage return without a line 


feed advance. If current printer can do a 
carriage return without a line feed, this 
control code causes the characters following 
to be over printed on the current line. 
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V causes TRSDOS-16 to output the filespec to the 
video display, as well as to the printer. 


NOTE: Use the A option only when filespec contains the 
control codes listed. 


Example 
PRINT PROGRAM/TXT V <ENTER> 


outputs PROGRAM/TXT to the video display, as well as to the 
printer. 


PROT 
PROT drive {options} 


Changes password protection of the disk in the drive ona 
large scale. 


The options can be any of the following: 

OLD=password specifies the disk's current 
master password. You cannot use any of the 
remaining options without specifying this. 

NEW=password assigns the TRSDOS-16 disk the new 
master password. 

LOCK tells TRSDOS-16 to assign all user files the 
latest master password. Both update and access 
words are then set to this password. (See ATTRIB 
for information on access and update passwords. ) 

UNLOCK tells TRSDOS-16 to remove passwords from all 
user files. 


A disk's master password is initially assigned during the 


format or backup process. The Model 16 systems disk is 
Supplied with the master password PASSWORD. 


Example 


PROT 1 OLD=PASSWORD, NEW=H2@ <ENTER> 
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changes the master password of the diskette in Drive l1 from 
PASSWORD to H20. 


PROT @ OLD=H20, UNLOCK <ENTER> 


removes passwords from every user file on the diskette in 
Drive Q@. 


PROT @ OLD=H20, NEW=ELEPHANT, LOCK <ENTER> 


changes the master password from H20 to ELEPHANT and assigns 
the new password to every user file. 


PURGE 


PURGE drive {options} 


Quickly deletes files from the disk in the specified drive 
number. 


drive is optional. If omitted, the primary drive is used. 


The options are: 
SYS System files (program and data) 


PROG User machine-language program files. 
DATA User data files. 
ALL All files, user and system. 


If the options are omitted, TRSDOS-16 only allows you to 
PURGE data files. 


Once you enter the PURGE command, TRSDOS-16 prompts you for 
the disk's password. Type in up to eight characters 

and press <ENTER>. (All disks distributed by Radio Shack 
use the password PASSWORD. ) 


The system then displays the file names, one at a time, 
prompting you to kill one file at a time, keep the file, or 
quit the operation. 


Example 


PURGE 1 <ENTER> 
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allows you to delete data files from Drive l. 
PURGE 2 {PROG} <ENTER> 


allows you to delete user machine-language program files 
from the diskette in Drive 2. 


RENAME 


RENAME filespecl TO filespec2 


Renames filespecl to filespec2. 

RENAME alters only the filename and extension, not the 
contents or the physical position of the file on the disk. 
The file's password also remains the same. (See ATTRIB to 
change the password. ) 

Example 


RENAME DATA/FLE TO DATFIL@#1 <ENTER> 


renames DATA/FLE to DATFIL@1. 
RESET 
RESET 
Resets/restarts TRSDOS-16. 
This command is almost the same as using the RESET switch. 


The RESET command closes all open files if you are at the 
TRSDOS-16 Ready prompt. 


Example 


RESET <ENTER> 
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RESTORE 


RESTORE source TO destination {options} 


Recovers any files stored on floppy diskettes that were 
saved with the SAVE command. Because SAVE stores files ina 
special format, RESTORE is the only way to return these 
files to the hard disk drive. 


source specifies a floppy diskette and is one of the 
following: 
drive specifies a drive number between 9-3. 
filespec:drive where filespec is a TRSDOS file 
specification and drive specifies a drive number 
between 9-3. 
| wildcard:drive where wildcard is a standard 
| TRSDOS-16 wildcard and drive specifies a 
drive number between @ and 3. 


c™ destination is optional, but may be one of the following: 
drive specifies a drive number between §-7, but may 

| not be the same as source. 

| filespec:drive if {options} is {IND}. 

| If {DIR} is specified in source, destination 

| cannot be specified. 

If omitted, destination is first available hard disk 

drive. 


The options and their meanings are: 

ABS tells TRSDOS-16 to retrieve the specified 
file(s). If used, TRSDOS-16 overwrites the 
already existing file with the same name. 

DIR If VOLUME @ is in source drive, TRSDOS-16 will 

display the DATASET directory and identifier; if 
VOLUME @ is not a source drive, TRSDOS-16 will 
display only the DATASET identifier. 

IND (indirect) tells TRSDOS-16 to use the contents of 
the destination file as a list of destination 
filespecs that meet the requirements stated above. 

KILL deletes the specified destination file before it 
is opened for RESTOREing. 

| PROMPT asks for verification of each file for 
RESTOREing. Press <Y> (yes), <N> (no), <Q> (quit 
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restoring), or <S> (stop prompt). 

PRT can only be used with the DIR option. Prints the 
DIRectory listing on the line printer 

SYS specifies that all System files will be 
retrieved. This includes System (language) and 
Applications programs. If used with DIR, SYS 
will list the directory of System files. 


RESTORE reads information from a DATASET created by SAVE. 


Tf a VOLUME of this DATASET is entered out of Sequence, 
TRSDOS-16 informs you of the mistake. The System also 
informs you if a VOLUME from a different DATASET is 
accidentally entered during a RESTORE. (See SAVE for 
explanation of DATASET and VOLUME.) 


When you're RESTOREing files in a DATASET, TRSDOS-16 prompts 
you with: 


Mount NEXT Diskette in Drive n -- Press ANY Key to continue. 


which instructs you to enter the next VOLUME of the DATASET. 


Example 
RESTORE !:2 TO 4 <ENTER> 


recovers files from the floppy diskette in Drive 2 and puts 
them on hard disk Drive 4. 


RESTORE 1 PROGRAMS {IND} <ENTER> 
where PROGRAMS is an INDirect file containing the files: 


MAILIST/PRG: 4 
MAILDAT/TXT: 4 
CHANGES/TXT: 4 


recovers the files from the floppy diskette in Drive l, to 


the filespescs defined in PROGRAMS on Hard Disk Drive 4. 
Note that "TO" is optional. 
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RESTORE */SRC:0 4 <ENTER> 


Restores all user files SAVEd with the extension /SRC on 
Drive 0 to Hard Disk Drive 4 using the same file names. 


SAVE 


SAVE source TO destination {options} 


Creates a serial file-by-file backup of source onto 
destination. Normally, you'll want to use the SAVE 

command to backup your hard disk files onto floppy diskette. 
This backup will be a compact form which consumes 
approximately half the space that it would be on a standard 
floppy diskette. 


This gives you a floppy diskette copy of your files that can 
easily be carried to another hard disk system. It can also 
be used to create a "Safe" copy of important files. 


The only way to retrieve a file in this "compact" format is 
with the RESTORE command. Any attempt to access a SAVEd 
diskette using a TRSDOS-16 command will cause the System to 
appear "“locked-up" for a short period of time while 
TRSDOS-16 attempts to read the SAVEd diskette. 


source can be one of the following: 
drive specifies a drive number between 0-7, but may 
not be the same as destination (ALL must be 
specified). 
filespec:drive if {options} is {IND}. 
wildcard:drive is a TRSDOS-16 wildcard and includes a 
drive number (0-7). 


destination specifies a floppy diskette and is one of the 
following: 
drive specifies a drive number between 0-3. 


options and their meanings are: 
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ABS tells SAVE not to prompt for destination diskette 
status. It formats the destination diskette if it 
isn't already in SAVE format. 

DC value date compares the creation date of each 
specified source file against the date entered and 
SAVES the file if all other criteria are met. 

DM value date uses the last modification date in 
the manner specified above. 

IND (indirect) tells SAVE to use the contents of the 
source file as a list of source filespecs that 
meet the requirements stated above. 

PROMPT asks for a file verification before SAVEing. 

You may respond with <Y> (yes), <N> (no), Q (quit) 
or <S> (stop prompting and continue). 

ALL tells TRSDOS-16 to save all files. (ALL won't 
transfer system files, use SYS.) If you use 
drive aS source, you must use ALL. 

SYS allows you to SAVE language and application 
programs. 


Note: value is <, >, or = where < (less than) and > 
(greater than) mean less than or equal to and greater 
than or equal to. 

date must be in the form: MMDDYY 


When the ABS option is used with SAVE, TRSDOS-16 will write 
over any diskette. If ABS is not used, you will be prompted 
Lipset. 


SAVEing Multiple Diskettes 


Since the hard disk drive is a larger storage system than 
the floppy diskette, it is sometimes necessary for SAVE to 
store information on more than one diskette. In these 
cases, SAVE prompts for the insertion of a new diskette. 


There are two terms relative to SAVE which you need to be 
familiar with: 


DATASET A set of one or more diskettes created by SAVE. 


VOLUME An individual diskette that is a member of a 
DATASET. 


TRSDOS-16 numbers the VOLUMES sequentially from @. Each 
DATASET contains a unique identifier so each SAVE VOLUME is 
identified by its serial position in a specific DATASET. 
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This prevents the accidental mixing of DATASETS within each 
other. 


If a SAVEd file requires more than one floppy diskette, the 
DATASET identifier enables you to keep track of diskettes in 
the same VOLUME. For instance, DATASET identifier 84 4E 56 
may include VOLUMEs 0, 1, and 2. 


When you are SAVEing files that require more than one 
Volume, ‘'TRSDOS-II prompts with: 


Insert NEXT Blank Diskette on Drive n -- 
Press ANY Key to Continue. 


When you do this, TRSDOS-16 then prompts with: 


The Diskette Presently on Drive n 
will be referred to as "VOLUME Xx" 


When all files have been SAVEd, TRSDOS-16 then prompts: 
Insert "VOLUME 0" on Drive n -- Press ANY Key to Continue 


When you re-insert VOLUME 0, TRSDOS-16 then writes it 
housekeeping information to this diskette. This allows it 


to record the number of volumes in the DATASET, etc. for use 
when it RESTOREs the SAVEd files. 


Examples 


There are a variety of ways to use SAVE. The simplest of 
these is: 


SAVE !:4 TO 2 <ENTER> 


This simply copies all the files on hard disk Drive 4 ina 
compact form onto the diskette in Drive 2. 


WILDCARDING 


Wildcards also offer a simplified method of saving files 
(these can be several files, or an entire disk). For 
example: 


SAVE */CBL:4 TO 0 <ENTER> 
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SAVEs all files with the extension /CBL from Drive 4 to the 
diskette in Drive @. 


USING THE INDIRECT OPTION 


The INDirect option allows you to save groups of files by 
creating an INDirect file (a file consisting of one or more 
filespecs -- similar to a DO-file). The only way to do this 
is to create a BUILD file under the TRSDOS-II operating 
system. (For complete details on BUILD, see your TRSDOS-IT 
Reference Manual. ) 


Reset your computer to start-up under TRSDOS-II and when 
TRSDOS-II Ready is displayed, type: 


BUILD PROGRAMS <ENTER> 


TRSDOS-II then will prompt you to enter the command line. 
To do so, type in the names of the files you wish to store. 
For example, type: 


ORDERS:5 <ENTER> 
REPORTS /*:6 <ENTER> 


and press <BREAK> to return to TRSDOS-II Ready. 


You are now ready to SAVE your INDirect file from hard disk 
to the specially formatted floppy diskette. Type: 


SAVE PROGRAMS:4 TO @ {IND} <ENTER> 


Both ORDERS and REPORTS are now found in the file named 
PROGRAMS on the floppy diskette in Drive 9. 


NOTE: Because the INDirect option allows you to SAVE 
multiple files from more than one hard disk, there is a 
chance that you could SAVE more than one file with the same 
name. The SAVE and RESTORE DiIRectory does not specify drive 
numbers for files, therefore you could possibly lose some of 
the duplicate filenames. 


For example, if you created an INDirect file consisting of 
these files: 


*/FOR: 4 


* /CBL: 4 
*/FOR:5 
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there is the chance that there are duplicate filenames on 
drives 4 and 5. Therefore, before using the INDirect 
option, we suggest that you examine all the files to be 
SAVEd. If there are duplicate names, RENAME those files 
before SAVEing. 


USING THE DC AND DM OPTION 


Another way to SAVE files is to do so in respect to their 
creation or modification date. For example, if your 
directory showed these creation and update dates for your 


files: 

Filename Created Updated 
MENU/PRG 6/1/81 9/2/81 
PRGONE/PRG 6/1/81 8/16/81 
PRGTWO/PRG 6/1/81 7/30/81 
PRGTHR/PRG 6/1/81 6/16/81 
PAYROLL/DAT 9/15/81 10715782 
CHECKS/DAT 9/15/81 10715/81 
TEST/PRG 10/29/81 10/29/81 


SAVE */PRG:5 TO 0. 


The most efficient way to SAVE these files would be by 
comparing the file creation date to a specified date. For 
example, all of the first four files were created on June l, 
1981 (6/1/81). Therefore, type: 


SAVE */*:5 TO 0 {DC=060181} <ENTER> 


and the first four files would be SAVEd to the floppy 
diskette in Drive 0. 


In the same sense, the first four files were modified 
(updated) on or before September 2, 1981 (9/2/81). 
Therefore, type: 


SAVE */PRG:5 TO 0 {DM<090281} <ENTER> 


and all files modified before the specified date would be 
SAVEd. 
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SETCOM 
SETCOM {options} 


Sets up the A or B channels (on the back panel) for 
communicating with a remote device, via a modem or hardwire 
connection. 


(If you are not a machine language programmer and want to 
communicate with a remote device, you need to buy a 
communications program. The manual that comes with it will 
explain how to use it. See your Radio Shack store for 
information. ) 


SETCOM without any options tells TRSDOS-16 to display the 
status of both serial channels. 


The options are: 
A=OFF turns off the A channel's RS-232 Communication 


settings. 
B=OFF turns off the B channel's RS-232 Communication 
settings. 


A=(baud rate,word length,parity,stop bits) 


sets the A Channel for RS-232 communication. 


B=(baud rate,word length,parity,stop bits) 


sets the B Channel for RS-232 communication. 


The RS-232 settings can be the following: 


baud rate 119, 158 300, 609, 1200, 2490, 4809, 
969%. If not specified, 39% is used. 
(Some programs will not run correctly 
at speeds higher than 249% baud.) 


word length Se Gy Ty Be LE NOL specitied, 7 216 
used. 

parity E-for even, O for Odd, N for none. If 
not specified, even is used. 

stop “Dlts 1, 2. If not specified, 1 is used. 


Every option but the last must be followed by a comma. The 
options are positional; e.g., the third item in an option 
list must always specify parity. To use a default value, 
omit the option and insert only the comma. 
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To change the settings on a currently active channel, first 
turn the channel OFF. If the channel is already off when 


you try to turn if off, you'll get an error message. 


Before executing this command, connect the remote device to 
the A or B channel. 


Then, after executing it, you can begin sending and 
receiving data, using one of these TRSDOS-16 Supervisor 


Calls. (See the Technical Information Section for details.) 
ARCV Channel A receive 
ATX Channel A transmit 
BRCV Channel B receive 
BTX Channel B transmit 
ACTL Channel A control 
BCTL Channel B control 


These system routines are only available when the respective 
channel has been initialized. See Technical Information for 
details. 


Example 


SETCOM A=( ) <ENTER> 


sets up channel A for serial communicaitons, using all the 
default parameters. System function calls 96 and 97 are 
available for serial I/O. The status of channel B is 
unchanged. 


SETCOM B=(600, 8, , 2), A=OFF <ENTER> 


sets up channel B: 


baud rate 600 

word length 8 bits 

parity Even (default) 
stop bits 2 


and turns channel A OFF. 


SETCOM ARC L200 7-184 °O7 07 sBSl -¢ oo vy 22 KBNTERS 


Radie Shaek 


a9 


TRSDOS-16 OWNER'S MANUAL TRSDOS-16 SYSTEM COMMANDS 


TRS-8O ° 


sets up channels A and B. 


Channel A Channel B 


baud rate 12909 398 (default) 
word length 8 7 (default) 
parity Odd Even (default) 


stop bits l(default) 2 
SETCOM <ENTER> 

displays the status of both channels. 
SETCOM A=OFF, A=( ) <ENTER> 


resets channel A to default parameters. 


SIZE 


SIZE 


Returns the amount of user memory currently available. 


Example 


SIZE <ENTER> 


SPOOL 


SPOOL {options} 


Captures printer output or prints a spool file. 
SPOOL increases the efficiency of the system by allowing you 
to use the system while a print operation is in progress. 


The {options} control the spool function. If omitted, the 
SPOOL status is displayed. 


The options are: 
ON activates the spooler. You must set this switch 
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before you can use the other switches. 

OFF turns off the spooler and closes the capture- and 
print-files. 

N,F=filespec creates a capture file named filespec 

P,F=filespec begins background-printing. filespec 
1s the file to be printed. 

K keeps the file after printing it. If omitted, 
deletes the file after printing it. (TRSDOS-16 
won't delete a print-file if the file is closed by 
a SPOOL S or if a disk error occurs in the print 
ELLE.) 

C=n specifies the number of copies you want. If 
omitted, one copy is made. n can be any number 
from2. oe: .255< 

L=line specifies the line number where printing 
starts. A line is a sequence of characters 
terminated by a carriage return. If omitted, 
printing starts at line one. line may be any 
number from 1 to 65535. 

H halts background-printing but saves the current 
position for later resumption (R switch). 

R,L=line resumes background-printing after a halt 
(H switch), or displays the current line number if 
the spooler has not been halted. If L=line is 
used, printing resumes at the specified line. If 
omitted, printing resumes at the point where it 
was stopped. 

S stops printing. It closes but doesn't kill the 
print-file and leaves the capture-file open. 


The TRSDOS-16 spooler performs two functions which you can 
use Simultaneously or one at a time: 


oF 


[It saves or "captures" the data that normally goes to 
the printer. The spooler then can either throw away 
this captured data or save it in a capture-file for 
later use. 


It prints data from a disk file while other operations 
are in progress. That is, you can use the system -- 
everything except the printer -- while printing the 
file. While the spool-file is printing, your system 
captures the real-time printer output for later use. 


Example 1 
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CAPTURE-FILE 
In this example, you can run a program that outputs to the 
printer. Instead of waiting to use your system until the 
printing is complete, you can capture the program in a disk 
file to print out later. 
To do this, call the capture-file SPOOL1 and type: 

SPOOL ON <ENTER> 

SPOOL N,F=SPOOL1 <ENTER> 
This saves all printer output in SPOOL1. To stop capturing 
the printer output in SPOOLI1, type: 

SPOOL OFF <ENTER> 
Now SPOOL] is a text file which you can LIST or PRINT in the 
normal means, but at your convenience. 
Example 2 
BACKGROUND PRINTING 
Here you can print to a file created by the spooler while 
you simultaneously use the system. Using the SPOOL] file 
from the first example, type: WwW 

SPOOL ON <ENTER> 

SPOOL P,F=SPOOL1 <ENTER> 
TRSDOS-16 begins printing the file as a "background task", 
i.e., printing takes place only when the system isn't busy | 
with some higher priority operation such as interpreting and 
executing your keyboard commands. Because this example 
doesn't include the K or C=copies option, TRSDOS-16 deletes 
SPOOL] after it prints it and prints only one copy. 
Type: 

SPOOL OFF <ENTER> 
after completing the print-file since the spooler doesn't 
turn itself off. 
Example 3 
SIMULTANEOUS CAPTURE-FILE AND BACKGROUND PRINTING 

® 
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To save real-time printer output at the same time as the 
spooler prints a file, you can use this example. 


First you need one capture-file (SPOOL1) and one print-file 
(SPOOL2). To turn the spooler on and begin capturing 
printer output in SPOOLI1, type: 


SPOOL ON <ENTER> 
SPOOL N,F=SPOOL1 <ENTER> 


You can now use the computer normally until you're ready to 
print out SPOOL1. To do so, type: 


SPOOL N,F=SPOOL2 <ENTER> 


This closes SPOOL1 and makes SPOOL2 the new capture-file. 
To begin printing SPOOL1, type: 


SPOOL P,F=SPOOL1 <ENTER> 


which prints out SPOOL1 and saves any real-time printing in 
SPOOL2. 


If you want to halt the print-file operaton, type: 
SPOOL H <ENTER> 


This doesn't affect the capture-file operation. To resume 
printing, type: 


SPOOL R <ENTER> 


Moves the printer to the next page (top of form). This 
command is like FORMS with the T option. 


If you are currently using spooler and it is capturing, Zh 
sends Top-Of-Forms character X'OC' to the spooler capture 
file. 


Example 
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T <ENTER> 


starts a new page after printing a file. 


TERMINAL 


allows communication between your computer and another 
computer running a host program. TERMINAL can only be used 
for transmission and reception of ASCII text rather than 
machine-language object code. 


Input/Output is through Serial Channel A. In most 
applications, hookup is through telephone lines via a modem. 


TERMINAL has three modes of operation, all described in 
detail in MODES OF OPERATION: 
Menu allows you to select or change options, and even 
execute TRSDOS-16 system commands. 
Interactive terminal transmits your keyboard input WY 
and displays incoming data. 
Transmit from RAM for high-speed transfer of prepared 
data. Incoming data is displayed on the screen. 


SETTING UP 


For communications through telephone lines, you need a modem 
such as the Telephone Interface II, (26-1171), Modem I 
(26-1172), or Modem II (26-1173), and the RS-232 Cable, 
26-4493. 


ie Set up the modem according to its instructicns, and 
connect it to Serial Channel A on the back panel of the 
computer display console. If Serial Channel B is not 
connected to another device, install the serial 
terminator on that channel. 


2s Set the modem to originate or answer mode -- whichever 
is the opposite of the host program with which you will 
communicate. Set it to full or half duplex, again 
depending on the requirements of the host program. 
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ae Turn on the modem and your computer system. 


4, Find out what RS-232C parameters are required by the 

host program you plan to use: 

Baud Rate 

Word length 

Parity 

Number of stop bits 
Initialize Serial Channel A accordingly (see RUNNING 
TERMINAL ). 


Serial Channel A 


Figure 4, Connect RS-232-C Cable from Modem (or other 
Serial I/O device) to Serial Channel A on the back panel of 
your computer, 

Notes In the examples illustrating sample uses of 
TERMINAL, underlining indicates what you should see on 


your display. The information following the underlined text 
is what you type. 


RUNNING TERMINAL 

1. From TRSDOS-16 Ready, you can start TERMINAL by typing: 
TERMINAL <ENTER> 
The program starts up in the Menu mode with the prompt: 
-- Enter Menu Selection .. 


Initialize Serial Channel A according to the 
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requirements (Baud Rate, Word Length, Parity, and Number 
of Stop Bits) of the host program you will communicate 
with. Type: 


S <ENTER> 


When the program prompts you to type in a TRSDOS-16 
command, type in the SETCOM command just as you would in 
the TRSDOS-16 Ready mode. For example: 


SETCOM A=(30@,7,N,2) <ENTER> 


enables Serial Channel A with 39@ baud, seven-bit words, 
no parity and two stop bits. After executing the 
command, control will return to TERMINAL's Menu mode. 


3. If you plan to use the printer option (P) of TERMINAL 
(described later), initialize the printer now with the 
FORMS command. Type: 


S <ENTER> 
and enter the appropriate FORMS command at the prompt. 


4, To select another menu command, type in the letter 
specified in the Menu. (See the Menu Commands Section 
for a list of the available commands.) To redisplay the 
entire Menu, type: 


M <ENTER> 


MODES OF OPERATION 


Menu Mode 

is an off-line mode, i.e., you cannot transmit characters to 
the host program, and if characters are sent to you, they 
will be lost. This is the only mode where you can select 
Menu options. You can also enter the Transmit from RAM or 
Interactive Terminal mode from the Menu mode. 


Interactive Terminal Mode 

sends the characters yor type to the host program and 
displays incoming characvers as they are received. If the 
host program echoes your transmissions, they also will 
appear on the display; if not, you can select the echo 
option to instruct TERMINAL to display your keyboard input. 
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You can save incoming characters in the RAM buffer (R 
option) and output them to the printer (P option). 


If transmission errors occur, TERMINAL displays a 
descriptive error message and waits for the error condition 
to be corrected. When it is, normal I/O resumes in the 
Interactive Terminal mode. 


There are three ways to enter this mode: 


1. With the T command from the Menu mode. 

2. With the O command -- upon completion of an auto 
Sign-on. 

3. After transmission from the RAM buffer. 


To return to the Menu mode, press <BREAK>. 


NOTE: Certain hosts will prompt you to use a break 
character or sequence to initialize transmissions. Since 
the <BREAK> key sends the program from the Terminal Mode to 
the Menu Mode, your computer uses <ESC> for this break 
character. You can also set your own break character or 
sequence with the B command. 


Transmit from RAM (and Auto Sign-On) 
sends the contents of the RAM buffer to the host program, 


and passes control to the Interactive mode. Auto sign-on (0 
command) works in the same way as transmit from RAM. (The 
following applies to both operations. ) 


Load the RAM buffer with prepared text from a disk file with 
the G option. (If you are using auto sign-on, your auto sign 
on message is sent.) You can send the data in the RAM 
buffer one line at a time when the host program prompts you 
that it is ready (W option), or you can send it ina 
continuous stream. 


During the transmission, your computer displays incoming 


text on the screen. If the host program echoes your 
transmissions, you can verify that the data was accurately 
sent. 


During the transmissions, adjust the delay between 
characters by repeatedly pressing the <up arrow> (faster) 
and <down arrow> (slower) keys. If echoed data appears 
garbled, slow down the transmissions. If not, you might 
want to speed it up. 
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If TERMINAL receives a break character or sequence in this 
mode, it pauses until it receives the next character. If an 
H'13" is received, TERMINAL will pause until an H'll' is 
received. (By convention, H'l3' is called the DC3 signal 
and means pause; H'll' is called the DCl signal and means 
resume). 


Use the X command to enter this mode. 


To exit this mode and return to the Menu mode, press 
<BREAK>. 


TERMINAL COMMANDS AND OPTIONS 


A Build Auto Sign-On Message -- Allows you to prepare an 
automatic sign-on to be sent to the host with the O option. 
The message should contain the responses you use to answer 

the standard sign-on questions provided when you first call 
a host. 


The message can be up to 69 keyboard characters, including 
control characters. All control characters will be 
displayed as +, but the true control code will actually be 
sent. (When you display a message, no control codes will be 
shown.) To imbed a carriage return (H'@D') in the message, 
press <down arrow>. 


For example, if the host requires responses to these prompts 
during sign-on: 


User ID? 
User Password? 


Program Name? 


instead of typing the information each time you call the 
host, you can store the responses in an auto sign-on buffer. 
To store the following information in the buffer: 


STL-314 <H'@D'> 


SHOWME <H'#D> 
MENU <H'@D'> 


Type: 
=-Enter Menu Selection.. A <ENTER> 
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The Current Auto Sign-On is 


Change? (Y/N) Y <ENTER> 
Enter Auto Sign-On Message (1-69) 
STL-314 <down arrow> SHOWME <down arrow> MENU <ENTER> 
The Current Auto Sign-On is 
STL-314 
SHOWME 
MENU 
-- Enter Menu Selection .. 


The blank line above Change? (Y/N) Y <ENTER> indicates 
that the original auto sign-on was blank or contained 
non-display characters. 


B Set/Change Break Character or Sequence -- Allows you to 
select the incoming code that will be interpreted as a 
"break" and also lets you define a key to send the same 
break character or sequence. 


You can use any code from § to 255 as the break character; 

you can specify any duration from 1 to 451 milliseconds for 

the break sequence (this is determined by the host program). 

For the user-defined break key, you can use any key except 
c™ <BREAK> or <CTRL> <C>. 


The following example shows how to set up H'@A' as the break 
character, and <CTRL> <D> as the break key: 


=-Enter_ Menu Selection B <ENTER> 


Break Key is Now 1BHex 

Change? (Y/N) Y <ENTER> 

Enter New Key (1) <CTRL> <D> <ENTER> 
Break Key is Now $4 Hex 

Type of Break is Now CHR 


Change? (Y/N) N <ENTER> 
Break Char is Now §@3 Hex 


Enter new CHAR Value in Hex (2) @A <ENTER> 
Break Char is Now @A Hex 


Cc Copy RAM Buffer to Disk -- Creates a disk file copy of 
the text in the RAM buffer. The new file will have a record 
length of one. 


Use this command to save data received into the RAM buffer 
in the Interactive Terminal mode. To minimize hookup time, 
do this after ending the connection to the host program. Or 
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if the RAM buffer is full, save it ina disk file, then 
reset it and reopen it for more data. 


For example, to save a report you have just received in the 
Interactive Terminal mode as a disk file named REPORT, type: 


-- Enter Menu Option.. C <ENTER> 


Enter Filespec (1-34) 
REPORT <ENTER> 


The new file will be created (if REPORT already exists, it 
will be overwritten with the new data), and the RAM buffer 
contents and status will be unchanged. 


To stop the copy process, press <BREAK>. The disk file will 
be closed and you will be returned to the menu. 


D Display RAM Buffer -- displays the contents of the RAM 
buffer. To pause the display, press <HOLD>. To continue, 
press <HOLD> again. If the printer option is on when you 
issue this command, the text will also be output to the 
printer. To enter the command, type: 


--Enter Menu Selection.. D <ENTER> 


To stop the display function, press <BREAK>. You will be WwW 
returned to the menu. 


E Toggle Self Echo Option -- Allows you to display the 
characters you send via the TERMINAL. 


Some hosts echo the text you send. As the host receives 
each character, it sends it right back to you and what you 
sent is displayed on the screen. When communicating with 
this type of host, set your modem to full duplex. 


If the host does not echo your text, what you send will not 
be displayed unless you use the self-echo option. With such 
hosts, set your mode to half duplex. 


To toggle the echo option, simply type E <ENTER>. The new 
state of the option (ON or OFF) will be displayed and the 
menu prompt will return. 


F Set/Change <Fl> and <F2> Keys -- Allows you to program 


<Fl> and <F2> to output any code from 9-255. This is useful 
if you use a particular code frequently. 
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For example, if the host recognizes H'13' (<CTRL> <S>) as 
pause control and H'll' (<CTRL> <Q>) as resume control, you 
may want to change these to <Fl> and <F2> for convenience 
sake. To do this, type: 


~~ Enter Menu Selection.. F <ENTER> 


Fl Key Will Send a §1 Hex Code 

Change? (Y/N).. Y <ENTER> 

Enter New Char Value in Hex (2) 11 <ENTER> 
Fl Key Will Send a 11 Hex Code 

F2 Key Will Send a §2 Hex Code 

Change? (Y/N).. Y <ENTER> 

Enter New Char Value in Hex (2).. 13 <ENTER> 


F2 Key Will Send a Hex Code 


Now when you type <F1> in the Interactive Terminal Mode, 
TERMINAL will transmit the resume control H'll'; for <F2>, 
the pause control H'l13'. 


G Get Disk File into RAM Buffer -- lets you load text 
stored in a disk file into the RAM buffer and then send it 
to the host via the X command (transmit from RAM). The 


previous contents of the RAM buffer are lost. 


The disk file can contain fixed- or variable-length records 
of any length. However, only ASCII files should be loaded 
and sent. You can send any programs as long as you saved 
them in ASCII format. 


For example, to send a document stored in the file 
DOCUMENT/TXT type: 


--Enter Menu Selection.. G <ENTER> 
Enter Filespec (1-34) 
DOCUMENT /TXT <ENTER> 


TERMINAL will load the file and return to the Menu. The RAM 
buffer will be closed. 


If the host program is ready to accept data, you can now 
send it with the X command. After transmission is complete, 
TERMINAL will go to the Interactive Terminal mode. 


L Toggle Line Feed Option -- tells TERMINAL how to handle 
an incoming line H'fA'. When the option is on, all line 
feeds are ignored; when off, they are not ignored. 
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This is useful if the host always sends a line feed after a 
carriage return. Since the TRSDOS-16 display and printer 
drivers automatically perform a line feed after a carriage 
return is sent, the incoming line feed is redundant. 
Therefore, the line feed option should normally be on. 


To toggle the line feed option, simply type L <ENTER>. The 
new state of the option (ON or OFF) will be displayed and 
the Menu prompt will return. 


M Display Menu -- Clears the display and redisplays the 
Menu. Use this command when you have entered so many 
commands that all the Menu commands are not visible. 


O Enter Terminal Mode with Auto Sign-On -- Starts 
transmission of the current auto sign-on message. After it 
sends the message, TERMINAL enters the Interactive Terminal 
mode. 


To stop transmitting the auto sign-on, press <BREAK>. This 
returns control to the menu. 


For details, see "Transmitting from RAM." 


Note: Most host programs cannot receive anything until 
they send the first prompting message. Because of this, you 
should: 


1. When connection is first made, go to the 
Interactive Terminal mode (T option) and wait for 
the host to send its first prompt character. 

2. Press <BREAK> to return to the menu. 

3. Start the auto sign-on (O option). 


P Toggle Printer Option -- Turns the printer option ON 
and OFF. When ON, incoming text is copied to the printer as 
it is received and displayed. Initialize the printer with 
the FORMS command before you try to use it. When you use 
the D command while the P option is on, the RAM buffer text 
is copied to the printer. 


TERMINAL uses a circular buffer for efficient output to the 
printer. If characters come in too fast, they will not be 
printed. They will be displayed, though, and saved in RAM 
if the buffer is open. (Check your printer's specifications 
for maximum character input rate. At 39M baud, 7-bit 
characters may come in as fast as 38 per second.) 


Radie Shaek 


92 


TRSDOS-16 OWNER'S MANUAL @ TRSDOS-16 SYSTEM COMMANDS 
TRS-80O 


To minimize hookup time, do not use the printer option while 
on-line with the host. Save the incoming text in RAM and 
upon completion of the hookup, turn the printer option on 
and use the D command to get a hard copy of the data. 


To toggle the printer option, simply type: P <ENTER>. The 
new state of the option (ON or OFF) will be displayed and 
the menu prompt will return. 


Q Quit -- returns control to TRSDOS-16. If there is data 
in the RAM buffer, it is lost: i.e., you cannot restart 
TERMINAL and recover the date. 


R Toggle RAM Buffer Option -- (Interactive Terminal Mode 
only) lets you save in RAM some or all the data received by 
"opening" and "closing" the RAM buffer. With this, you can 
examine the data later with the D command, or save the data 
in a disk file with the C command. 


When you open the RAM buffer, you can either reset it or 
retain its current contents. If you retain the contents, 
new incoming text will be loaded after the existing text in 
the RAM buffer. 


To toggle the RAM buffer option, simply type R <ENTER>. The 
new state of the option (OPEN or CLOSED) will be displayed. 
If you have just opened the buffer, you will receive the 
following prompt: 


RAM Buffer Now Open 
Reset RAM Buffer? (Y/N) .. 


If you type Y <ENTER>, the buffer will be reset and previous 
contents will be lost. For more information, see "Using the 
RAM Buffer". 


S Perform System Command -- enters the operating system 
and allows you to enter a TRSDOS-16 system command. After 
it executes the system command, control returns to 
TERMINAL's Menu. A few TRSDOS-16 commands and programs 
automatically return to TRSDOS-16 Ready. If you execute any 
of these commands while in TERMINAL, control will not be 
returned to TERMINAL, but to TRSDOS-16 Ready. 


T Enter Terminal Mode -- directly enters the Interactive 


Terminal mode. When in this mode, press <BREAK> to return 
to the Menu. 
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V Toggle Video Filter -- filters out data characters 
which produce undesirable results when output to the 
display. 


When a character such as ESC(H'1B) is output, it causes 
Terminal to clear the screen and home the cursor. With the 
video filter option, you can prevent this by "filtering" 
these characters from the display. If the RAM buffer is 
open, they will be saved in RAM, regardless of the state of 
this option. 


The codes (given in hexadecimal) which this option filters 
are: 


01,62,03,04,65,86,67,0B,0C, PE, MF, 
1f,11,12,13,14,;15,16,18,1F 


If Terminal receives any of these characters while the video 
filter 15 on) 1 will display a "2" .2m.2ts place. 


W Set/Change Prompt Wait Character -- allows you to 
toggle this feature on or off and set a special character as 
the prompt-wait character to cue the terminal to continue 
the transmission. 


This allows you to use the high speed transmit from RAM 
mode, even when the host program can accept only one line at 
time. (It does not affect operation in the Interactive 
terminal mode.) 


Normally, the host program sends a prompt such as a question 
mark when it is ready for the next line. ( A line is 
defined as a string of characters terminated by a carriage 
return H'@D'.) In the Interactive Terminal mode, you simply 
wait until this prompt is displayed; the prompt wait feature 
makes TERMINAL do the same thing while in the transmit from 
RAM mode. 


You can define the prompt wait character as any keyboard 
eharacter: Erom H°20" to A" 7k. 


Leave the prompt wait feature off when the host program is 
simply storing characters as received and is not sending a 
ready-for-next-line prompt. TERMINAL will transmit text 
from RAM in a continuous stream. 
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NOTE: When you start the transmit from RAM (X option) or 
auto sign-on (0 option), the first line is sent immediately, 
without waiting for a prompt. Each subsequent line is then 
sent after the prompt is received. 


To turn the prompt wait feature off, press <HOLD> when the 
program asks for a new character. | 


X Transmit RAM Buffer and Enter Terminal Mode -- enters | 
the Transmit from RAM mode where it sends the current | 
contents of the RAM buffer to the host program. When the 
entire buffer has been sent, TERMINAL goes into the 
Interactive Terminal mode. For details, see "Transmitting 
from RAM." 


To stop transmission from RAM, press <BREAK>. Control 
returns to the Menu. 


USING THE RAM BUFFER | 


You can use the RAM buffer to store incoming text (R option) | 
and prepared text from a disk file (G Opcicon).. This, 26 | 
turn, allows the stored files to be rapidly sent. The RAM 

c~ buffer helps reduce costly hookup time by letting you 
perform time-consuming operations -- preparing data or 
printing it out -- while TERMINAL is off-line. 


If the buffer is filled during a load from disk (G command) 
or while receiving data in the Interactive Terminal mode, a | 
warning message will be displayed and the buffer will be | 
closed. If you are loading a disk file, control returns to 
the Menu mode and the buffer will be filled with the data 
that was loaded. 


If you are in the Interactive Terminal Mode, normal I/O will 
continue, except that it will no longer be saved in the 
buffer. 


Saving the RAM Buffer 


When the buffer is filled in the Interactive Terminal Mode 
(or when you suspect it is almost full): 


ce Transmit a pause or break control character to the host 
program. 
Lis Press <BREAK> to return to the Menu. 
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Use the C command to copy the contents of the RAM 
buffer to a disk file. 

Reset the RAM buffer with the R command. 

Use the T command to return to the Interactive Terminal 
Mode. 


Opening and Closing the RAM Buffer 


To save portions of the text during I/O of the Interactive 
Terminal Mode, use the R command. Prior to receiving the 
data you want to save: 


Lis 


3% 


Transmit a pause or break control character to the 
host program. 

Press <BREAK> to return to the Menu. 

Use the R command to toggle the RAM buffer status. If 
it is off, toggle it again to open it. If if is 
already open, you have the option of resetting it or 
leaving it as is. To add new data onto the end of old, 
do not reset it. To delete old data, reset it. 

Enter the T command to return to the Interactive 
Terminal Mode. 

Direct the host program to resume transmission. The 
data will now be saved in the RAM buffer as it is 
received. 


Saving the Options You Have Selected 


You can save these options in a customized version of 
TERMINAL: 


. Prompt wait and definition of prompting character 

. Definition of break character or sequence from host 
program and assignment of a break key on your 
computer 

. <F1> and <F2> characters 

- Line feed option 

. Printer option 

- Self-echo option 

. Video filter option 

- Auto sign-on option 

- Speed of transmit from RAM and auto sign-on (as set 
by the "up"and "down" keys). Once you find out the 
maximum rate of transmission the host program can 
handle, you can set that as the default rate. 
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After you select the options for your customized version, 
use the DUMP command to create a new program file. Terminal 
resides from H'3@@f{'. Give this customized program a name 
other than TERMINAL -- and leave the TERMINAL program in its 
original configuration. 


For example, to call your customized version MINE, type: 


--Enter Menu Selection.. S <ENTER 
Enter TRSDOS Command (1-79) 
DUMP MINE START=30990, END=3FFF <ENTER> 


Now you have a customized version of TERMINAL that starts up 
when you type: 


MINE <ENTER> 


SAMPLE USES 


To Send a Program 


If you intend to send a program via TERMINAL, you must first 
Store it in an ASCII-format disk file. When you have done 
this, set up the modem and initialize Serial Channel A as 
explained previously. See your modem manual for the 
appropriate procedure for getting on-line. 


For example, to send a disk file named "SORTDATA" on Drive 
1, get on-line and load the TERMINAL program. Enter the 
Interactive Terminal mode by typing: 


Enter Menu Selection.. T <ENTER> 


Go through the necessary sign-on and when you want to send 
the program, press <BREAK> to return to the Menu. (If you 
want to use the prompt wait option, select it now.) Then 


type: 


--Enter Menu Selection.. G <ENTER> 
Enter Filespec (1-34) 
SORTDATA:1 <ENTER> 


TERMINAL will now load the program into RAM. Make sure the 
host is ready to receive the program, then type: 
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=-Enter Menu Selection.. X <ENTER> 


The Terminal will now send the program to the host. Press 
<BREAK> if you want to stop the transmission for any reason. 
This returns control to the Menu. Otherwise, upon 
completion of the program transmission, control will go into 
the Interactive Terminal mode. 


To Receive a Program 


If the host program you are communicating with is ready to 
send you an ASCII-formatted program, you must first go to 
the Menu and type: 


--Enter Menu Selection.. R <ENTER> 


Tf the buffer is now closed, repeat this command and 
TERMINAL will display the message: 


RAM Buffer Now Open 
Reset RAM Buffer (Y/N) Y <ENTER> 


This opens and clears the buffer. Now return to the 
Interactive Terminal mode (T option) and tell the host to 
send the program. 


After you receive the entire program, press <BREAK> to 
return to the Menu; then type: 


-—- Enter Menu Selection.. C <ENTER> 


Enter Filespec (1-34) 
NEWPROG <ENTER> 


This copies the program in RAM into a disk file named 
NEWPROG. 


ERROR CONDITIONS 


In the Interactive Terminal Mode, Transmit from RAM Mode, or 
during Auto Sign-on, TERMINAL may detect errors related to 
the serial transmission. In such cases, it will display an 
error message in reverse video and, if possible, will 
continue normal I/O. 


The error messages that may occur while you are in the 
Interactive Terminal Mode are: 
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P Parity error. The received character will be 
after the P. 
O Over-run. At least one character has been 


received but not picked up by TERMINAL. This 
occurs if you are in the Menu mdde while the host 
program is sending characters. 

F Framing error. The received character will be 
displayed after the F. Check your SETCOM 
parameters to see that they match the requirements 
host program. 


The following errors can occur in any mode except the Menu: 


DATA CARRIER LOST Check the telephone/modem 
connection. 

DATA CARRIER RESTORED TERMINAL will pause until the 
carrier is restored. If TERMINAL was transmitting 
from RAM or sending an auto sign-on, it will start 
over at the beginning of the text when data 
Carrier is restored. 

BREAK SEQUENCE RECEIVED If the host program sends a 
break sequence, or sends TERMINAL'S own break 
character, this message will displayed; if 
TERMINAL is in the transmit from RAM or auto 
Sign-on mode, it will pause until the next 
character is received from the host. 


TIME 
TIME 


Displays the date-time string. It works the same way as the 
DATE system command. The format for the date-time string 
is: 

WED MAR 25, 1981 84 -- 16.24.34 


for Wednesday, March 25, 1981, the 84th day of the year, 
4:24:34 p.m. 


Example 


TIME <ENTER> 
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VERIFY 
VERIFY {options} 
Sets the verify function ON or OFF. When ON, TRSDOS-16 
checks data after each write operation. 
The options are: 
ON tells TRSDOS-16 to check all data, as it writes 
Lt 
OFF turns VERIFY OFF 


If you do not specify an option, TRSDOS-16 returns the 
current status of VERIFY. 


When VERIFY is on, TRSDOS-16 reads after each write 
operation to ensure that the data is readable. If the data 
is not readable, TRSDOS-16 retries and, if data is still not 
readable, returns an error message. 


If you need to increase the speed of TRSDOS-16, turn VERIFY 
OFF . 


NOTE: TRSDOS always verifies directory writes. The VERIFY 
function checks only user writes (writing data into a file). 
Examples 

VERIFY ON <ENTER> 
turns the verify function ON. 

VERIFY OFF <ENTER> 
turns the verify function OFF. 

VERIFY <ENTER> 


displays the status of the verify switch. 


VERSION 
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VERSION 


Displays the version number of the operating system 
currently in use. 
Example 

VERSION <ENTER> 


returns -- Version: 4.1 -- indicating the major version 
level "4", minor version level "1", 
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MEMORY REQUIREMENTS 


TRSDOS-16 loads into memory at startup and occupies 
approximately 48K of memory. 


At this time TRSDOS-16 also processes your configuration 
command file (see APPENDIX B for information on the 
Configuration Command File). 


The configuration file tells TRSDOS-16 what files to load 
into memory for your use. This might include RUNCOBOL, and 
the Debugger. TRSDOS-16 loads these files into the memory 
area reserved for TRSDOS-16. 


Any memory following the configured files is available to 
you, the user. 


Note: The Editor, Assembler, and Linker load into user 
memory, not the Configurator memory. 


RELATIVE ADDRESSING 

TRSDOS-16 loads into memory ina way that is "invisible" to 
the user. This is TRSDOS-16's way of protecting itself 
from being modified by other programs. 


TRSDOS-16 internally keeps track of two addresses: 


the BASE address - this is the bottom of user 


memory. (Memory below this address is reserved for 
TRSDOS-16 and files designated by the configured 
file. 


the BOUNDS address - this is the top address of 
memory. (H'LFFFF in a 128K computer, H'3FFFF ina 
256K computer, H'SFFFF in a 384K computer, and 
H'TJPFEF in a S1L2K computer, ) 

In short: 


BOUNDS Address - BASE Address = User Memory 
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TRSDOS-16 uses the BASE Address to find the physical loading 
address of your program. When you write a machine-language 
program, you assign it a "relative loading" address, usually 
zero. TRSDOS-16 then adds the BASE address to this relative 
address to determine the physical address where it will load 
your program: 


BASE Address + PROGRAM RELATIVE ADDRESS = PHYSICAL 
LOAD ADDRESS 


TRSDOS-16 uses the BOUNDS address to find the amount of 
available user memory. This is how the Operating System 
determines if your program will fall out of the "bounds" of 
user memory. 
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BEGTNMING OF Ses “aceeS Sona ee eee 
MEMORY 


DEBUG 


RUNCOBOL 
IF LOADED 


BASE ADDRESS --> --------------------- 


USER 
MEMORY 


BOUNDS ADDR <--> 3------~--------------- 


TOP OF PHYSICAL --> --------------------- 
MEMORY (16K) 


MEMORY CHART 
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DISK ORGANIZATION 


FLOPPY DISKETTE 


TRSDOS-16 can use either single-sided (double density) or 
double-sided (double density) diskettes. However, if you 
are using an Enhanced Model II, you can use only 
Single-sided diskettes because of the type of drives you 
have. 


TRSDOS-16 will automatically format either single or 
double-sided diskettes according to the type of diskette. 


Each side of the double-sided diskette contains 77 tracks, 
numbered @ - 76. Therefore, the double-sided diskette can 
be thought of as one diskette with 154 tracks. 


The single-sided diskette has 77 tracks on one side only. 
Each track is made up of 32 sectors, numbered 1-32. Each 
sector contains 256 bytes, except for track @ (one side only 
on the double-sided diskette). This track @ is reserved for 
System use and is formatted single-density. It contains 26 
sectors and 128 bytes per sector. 

The total capacity of a double-sided diskette is: 


(153 °* 32° * 256) + (kL * 26 * 128) = 1,256,704 bytes 


The total capacity of a single-sided diskette is: 


(7G * 32% 256.90 + 4b * 26.* 128) = 625,929 


HARD DISK 


The TRS-8@ Hard Disk Drive is organized into 256 
"cylinders". Each cylinder is made up of four tracks that 
have the same radius on each of the four surfaces (4 * 256= 
1924 total tracks per hard disk). 
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Each track contains 34 sectors, numbered 1-34. Each sector 
contains 256 bytes. 
The total capacity of a hard disk is: 


(1924 * 34 * 256) = 8,912,896 bytes 
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DISK SPACE AVAILABLE TO USER 


TRSDOS-16 occupies approximately 31 tracks on the floppy 
diskette and approximately 32 tracks on the hard disk. 


Track @ is reserved by the System on both the floppy and 
hard disk. The hard disk also reserves track 1 for 
diagnostics. 


The directory and alternate directory on both the floppy 
diskettes and hard disk reserve a certain number of tracks, 
determined by the size of the directories (the size is set 
by the FORMAT command). 


To determine the number of tracks these directories will 
consume, use this formula: 


eS SEED TEED REED CRESS MRED VAD GREED HOD EE OED CGS OCD ORD SOUND SOOMED CURED FOUND JONES SEWED CUSED (ARES GORE SEED SSE SED GD A USS SEED NTE SAEED OED ED EE ED ED ED EE ED ED A REE EE AED ED OED AED WED OED ED ES a oe ee SS 
See SUD CS SO, NS A A AA AS A SS AS A SS AS A A A SS A AAD ED SD AS SS SS TS AS SD ES ED RD ED SNE SEE ERED EE “SORES ORD AED ERED ED SEND ED REED REED NEED SED OED GREED SRD AD NS AS TS AS EES 


# of filenames / 4 to determine number of 
(round result up to sectors used by the 
next integer value) primary directory 

# of sectors / 32 (floppy) to determine number of 
# of sectors / 34 (hard) tracks used by the 
(round result up to primary directory 


next integer value) 

+ Of Cracks * "2 to determine the total 
number of tracks used for 
the primary and alternate 
directories (the 
alternate directory is 
simply a copy of the 


Sees cee Se OD AD RS RS DS SS A A SS A A ES A A A A A AS A A AS AS A SS A A ES A RA A TS A A A A LS NEES RN AD CO TE ND VD ED SED RD NS OS AD AD A AT SVD OCCT 


Note: TRSDOS-16 stores 4 filenames per sector in the 
directory. 
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For example, if you use this Format command: 
FORMAT :l1 {PW=PASSWORD, SIZE=259} 


the directories will consume a total of four tracks: 


258 filenames / 4 = 6255 

round up = 63 

63 sectors / 32 (floppy) = 1.96 

round up = 2 tracks for each 
directory 

Lie 2 = 4 total tracks used for 


the primary and alternate 
directories. 
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UNIT OF ALLOCATION 


All allocation of disk space is made by single sectors. 
This means that the smallest non-empty TRSDOS-16 file will 
consist of one sector. 


Single-Sided 

Diskette Tracks Sectors Bytes 
a 76 2,432 G225592 
--- 1 32 8,192 
as ha A 256 

Double-Sided 

Diskette Cylinders Tracks Sectors Bytes 
1 76 154 4,896 T4255%¢376 
--- 1 2 64 16,384 
—--- --- Z 32 8,192 
--- --- --- 8 256 


Note: Track @ on the floppy diskette (only one side for 
double-sided diskettes) is reserved for System use and is 
not available for user storage. It is formatted single 
density with 26 sectors that contain 128 bytes each. 


Hard Disk Cylinders Tracks Sectors Bytes 
ie 256 1924 34,816 8,912,896 
--- J. 4 136 34,816 
— --- i 34 8,74 
--— ——— ae i 256 
® 
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DISK FILES 


METHODS OF FILE ALLOCATION 


TRSDOS-16 provides two ways to allocate disk space for 
Files: Dynamic Allocation and Pre-Allocation. 


DYNAMIC ALLOCATION 


With dynamic allocation, TRSDOS-16 allocates sectors only at 
the time of write. For example, when a file is first opened 
for output, no space is allocated. The first allocation of 
Space is done at the first write. Additional space is added 
as required by subsequent writes. 


With dynamically allocated files, unused sectors are 
de-allocated (recovered) when the file is closed. 


Dynamic allocation is the method TRSDOS-16 uses, unless you 
execute the CREATE system command. 


PRE-ALLOCATION 


With pre-allocation, the file is allocated a specified 
number of sectors when it is created. Pre-allocated files 
can only be created by the system command CREATE. 


TRSDOS-16 will dynamically extend (enlarge) a pre-allocated 
file as needed. 


However, TRSDOS-16 will not de-allocate unused sectors when 
a pre-allocated file is closed. To reduce the size of a 
pre-allocated file you must copy it to a dynamically 
allocated file. The COPY system command does this 
automatically when the destination is a 
dynamically-allocated file. 
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RECORD LENGTH 


TRSDOS-16 transfers data to and from disks one sector ata 
time; i.e., in 256-byte blocks. These are the System's 
"ohysical" records. 


User records or "logical" records are the buffers of data 
you wish to transfer to or froma file. These can be from l 
to 256 bytes long. 


The Operating System will automatically "block" your logical 
records into physical records which will be transferred to 
disk, and "de-block" the physical records into logical 
records which are used by your program. 


Therefore, your only concern during file-access is with 

logical records. You never need to worry about physical 

records, sectors, tracks, etc. This is to your benefit, 
since physical record lengths and features may change in 
later TRSDOS versions or with other peripheral devices, 

while the concept of logical records will not. 


From this point on, the term "record" refers to a "logical 
record". 


SPANNING 


If the record length is not an even divisor of 256, the 
records will automatically be spanned across sectors. 
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For example, if the record length is 29%, Sectors 1 and 2 
will look like this: 
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FIXED-LENGTH AND VARIABLE LENGTH RECORDS 


TRSDOS-16 files can have either fixed-length or 
variable-length records. Files with fixed-length records 
will be referred to as FLRs; files with variable length 
records, VLRS. 


Record length in an FLR file is set when the file is opened 
for the first time. This length can be any value from 1 to 
256 bytes. Once set, the record length in an FLR cannot be 
changed unless the file is being over-written with new data. 


The record-lengths in a VLR file can vary. For example, the 
first record ina file might have a length of 32; the 
second, 17; the third, 259; etc. 


The record length in a VLR file is specified in a one-byte 
length-field at the beginning of each record. The 
record-length byte indicates the entire length of the 
record, including the length-byte. This can be any value 
from @ to 255. A value of 1 can be used to mean an empty 
record (e.g., a blank line in an ASCII text file). 


Length 
Byte Data 


255 bytes of data 
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A length-byte value of 2 indicates that the record contains 
l byte of data: 


Length 
Byte 


one byte of data 


A length-byte value of 16 indicates that the record contains 
15 bytes of data: 


Length 
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RECORD NUMBERS 


Records are numbered from @ (beginning of file) to 
LO TTT, 2LAes 


A disk file can also contain up to 16,777,216 bytes of 
storage, however, your storage medium may not be capable of 
storing this much information. 


To determine the number of records a file will hold, use the 
following formula: 


16777216 / logical record length = number of records 


For example: 


16777216 / 38 = 441,595 records 


Example 


If a three megabyte file (possible with hard disk) is opened 
with a record length of 3 bytes, it would hold approximately 
1,008,988 records. 
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RECORD PROCESSING CAPABILITIES 
TRSDOS-16 allows both direct and sequential file access. 


Direct access -- sometimes called "random access", allows 
you to process records in any sequence you specify. 


Sequential access allows you to process records in sequence: 
Record N, Nt+l, Nt+2,.... With sequential access, you do not 
specify a record number; instead, TRSDOS-16 accesses the 
record following the last record processed, starting with 
record Q@. 


FLR files may be opened as either direct access or 
sequential access. 


VLR files can only be opened as sequential access. You 
cannot position to a specific record in the file, since the 
varying record lengths make it impossible to calculate the 
position of the VLRs. 


The direct access SVC's are DIRRD (Direct-Read) and DIRWR 
(Direct-Write). Direct access SVC's always access the 
record you specify. 


The sequential access SVC's are READNX (Read-Next) and 
WRITNX (Write-Next). Sequential access SVC's always access 
the record following the last record processed. (When the 
File is first opened, sequential processing starts with 
record §, however DIRWR and DIRRD can be used to position to 
tne BOF, end or. file.) 


EXAMPLES WITH FIXED LENGTH FILES 


Assume you have a Fixed Length Record file currently open. 
Here are some typical sequences you can accomplish via the 
file processing routines. 


1. Read and/or write records in the file -- in any order 
This is done using DIRRD and DIRWR SVC's. You could read 
record 5, write at end of file, read record 3, write record 
3) Ste% 
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2. Sequential Read (or Write) beginning anywhere in the 
file. | 

First you would do a direct-read to the record where you 
want to start reading or writing. After that, you would do 
sequential reads or writes until done (READNX and WRITNX). 
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3. Sequential Write starting at end of file. 
First do a direct-write to the end of the file. Then do 
sequential writes until done. 


4. Determine the number of records ina file. 

First do a direct-read to end of file, then use the LOCATE 
routine to get the current record number, which now equals 
number of records +l. 


EXAMPLES WITH VARIABLE LENGTH RECORDS 


Here are examples of ways to read or write VLR files: 


l. Start reading or writing sequentially at first record 
Open the file and start reading or writing sequentially 
until done. 


2. Sequential Write starting at end of file 
First do a direct-write to the end of the file. Then do 
sequential writes until done. 


Note: Whenever you write to a VLR, the end of the file is 
automatically reset to the last record you write. 


Also, you cannot update a VLR file directly. You must read 
in the file, update it and output the updated information to 
a new VLR file. 
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SUPERVISOR CALLS 


Supervisor Calls (SVCS) are operating system routines 
available to any user program. These routines alter certain 
system functions and conditions, provide file access, and 
perform I/O to the keyboard, video display, and printer. 


The available TRSDOS-16 SVCs are: 


KEYBOARD SVCs 
KBCHAR 
KBINIT 
KBLINE 
VIDKEY 


PRINTER SVCs 


VIDEO SVCs 
CURSOR 
VDCHAR 
VDINIT 
VDLINE 


SYSTEM CONTROL SVCs 


PRCHAR 
PRCTRL 
PRINIT 
PRLINE 


MISCELLANEOUS SVCs 


DEBUG MOUNT 

DISMOUNT MOVBUF 

EXECUTE RESET 

COMMUNICATIONS SVCs 

ACTL BCTL 

ARCV BRCV 

ATX Bw 
RS23.2C 


Bach SVC has a function code which you use to call it. 


CLRXIT 
DATE 
DOSCMD 
ERRMSG 
ERROR 


HLDKEY 
JP2DOS 
SETBRK 
SETTRP 
VERSION 


FILE ACCESS SVCs 


These codes range from @ to 512. 
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SVC BLOCK 


To use an SVC, you must assign it an area in memory called a 
BLOCK. You use this BLOCK to pass parameters to and from 
the SVC. 


The SVC block is a maximum of 16 words long. Each word 
consists of two bytes. 


These words are used to store parameters which you want to 
pass to or from the SVC. They are addressed by their 
byte-offset number, an even number ranging from @ to 32. 
Some SVC's will use only one byte of a word. In this case 
the byte will be located in the low order 8-bits (or 
byte-offset + 1). The high order 8-bits must contain 
zeroes. 


Certain parameters, such as memory addresses, will use two 
consecutive words of storage (called a long word). 


You can store an SVC BLOCK anywhere in memory; however, 
there must be a minimum of 32 bytes available after the 
starting address of the block, although the block may occupy 
less than last 32 bytes. 


Figure 5 is a sample SVC BLOCK. (DIRWR SVC -- write a 
record out to disk.) 


Radie Shaek 


L23 


TRSDOS 16 OWNER'S MANUAL TECHNICAL INFORMATION 


TRS-8O ° 

Byte-Offset 

SSS 

| g-1 | <-- TRSDOS SVC NUMBER 

+----- + 

| 2-3 | <-- Error Code (Returned) 

+----- + 

| 4-5 | <-- Reserved (must be Qf) 

+—---- + 

| 6-7 | <-- File ID 

+----- + 

; oo 

+----- + } Record Address 

|1g-11]| 

+----- + 

[12-13] 

+----- + } Record Number 

[14-15 | 

Ft 


Figure 5. Sample SVC BLOCK 


In this illustration, each box represents a word. The 
numbers within the boxes are the byte-offset numbers for 
addressing the SVC BLOCK. 


The first number (the even number) is used to reference the 
offset. For example, byte-offset §-l1 contains the SVC 
number, but is addressed as offset Q@. 


Byte-offsets 16 through 31 are not used for this SVC, and 
need not be present. 


The first three words of every SVC contain the same 
information: 


~-1 TRSDOS Function Code Number (for example, 35) 
2-3 On Error, returns the Error Code 
4-5 Reserved -- Must contain zero 


If an area within a block is marked RESERVED, you must set 
it to zero or a parameter error will occur. 
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CALLING PROCEDURE 
To call a TRSDOS-16 SVC: 


i Load the address of the desired SVC BLOCK into register 
AQ. 


2. Execute a BRK #@ instruction. 


Sis Upon return from an SVC, you must specifically TEST for 
for an error condition if you want to see if one 
exists. 


During the execution of an SVC, the SVC processor does not 
alter any registers, nor does it alter any status bits upon 
return. 


Figure 6 is part of a sample program for the DIRWR SVC. 
We'll look at it closely to see one of the ways to load a 
SVC BLOCK for execution. 


This sample assumes that the File Identification Number was 


previously stored in register Al, Record Address in register 
A2, and Record Number in register A3. 


WRITE LDA -Af,SVC BLOCK 


* line 1 
MOVW @AS,#DIRWR SVC NUMBER * line 2 
STW Al, 6@AQ * line 3 
STL A2,8@AQP * line 4 
STL A3,12@AQG * line 5 
BRK #Q * line 6 
TESTW 2@AG * line 7 
BNE ERROR * line 8 
SVC BLOCK 
RDATAB 32,0 * line 9 
DIRWR SVC NUMBER 
EQUW 44 * line 19 


Figure 6. Sample Program 
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In this program, line 1 loads the address of the SVC BLOCK 
into register AQ. 


Line 2 moves the function code number to byte-offset @ and 
line 3 stores the file identification number in 
byte-offset 6. 


Lines 4 and 5 store the Record Address and the Record Number 
in byte-offsets 8 and 12, respectively. Each is a long 
word. 


Line 6 executes the SVC. 

Line 7 tests for an error returned at offset 2. 

Tf there is an error, the return is non-zero and line 8 
either branches to an ERROR handling subroutine elsewhere in 
the program or executes the next line of the program. 


Line 9 defines the SVC BLOCK to 32 bytes of zeroes. 


And line 18 equates the SVC NUMBER to 44. 
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PROGRAMMING WITH USER INTERRUPTS 


TRSDOS-16 allows user-programmed interrupts as described 
under SETBRK and SETTRP. When the interrupt is received 
(that is, when the <BREAK> key is pressed or a system trap 
is taken), control transfers to your interrupt handling 
routine. 


When SETBRK terminates, or when an intercepted interrupt 
occurs, the following takes place: 


Ls The current User PC and status registers are 
pushed on the USER stack. 


2% A branch is taken to the user-specified address. 


Before doing any processing, you should save any registers 
you plan to alter. When processing is complete, execute an 
RTR instruction (return with restore) to return to the 
interrupted program. 


A fatal error occurs if TRSDOS-16 cannot push three words 
onto the user stack, i.e., if the stack pointer contains a 
H'4 or less. 


NOTE: Interrupt handlers entered this way are also subject 
to interrupts. 


CONVERSION OF RELOCATABLE TO REAL ADDRESSES 


If a byte-offset of an SVC 'points' to a buffer in user 
memory, the following restrictions apply: 


All buffers are checked against their maximum possible 
Sizes. It is not permissible to have a 256-byte buffer 
beginning 25 bytes from the end of memory. The check is 
made in this way: 


a DATE SVC buffer requires 26 bytes 
Zi ERRMSG SVC buffer requires 89 bytes 
Ss OPEN SVC parameter list requires 5 bytes 
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4. Any call passing a filespec (KILL, RENAME, etc.) 
requires a 34-byte buffer 

5. Any Disk I/O call passing a buffer address is 
checked for a 256-byte buffer 

6. Any miscellaneous I/O calls (PRLINE, VDLINE, etc.) 
passing a fixed length buffer is checked 
for 256 bytes. 
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ACTL Function Code 199 
Control Channel A 


Performs control functions on serial channel A and then 
returns its status. 


TRSDOS-16 sets up A/BRCV, A/BTX and A/BCTL when you 
initialize channel A/B with RS232C. If you call any of 
these routines while the channel is not initialized 
(active), you will get an error return code of 1 (no 
function code exists). 


Entry Conditions 


Byte-offset O-1 199 
6-7 option switch 
Exit Conditions 
Byte-offset 23 error code 
8-9 communications status code 


Valid option switch settings are: 


option Meaning 
Switch 
g Get status of serial channel into 
the Status Value 
l Get received buffer count into the 


Status Value 
2 Turn on Request to Send (RTS) signal 
3 Turn off RTS 
4 Start transmission of a BREAK sequence 
5 Stop transmission of a BREAK sequence 
6 Clears receive buffer 
7 Reset SIO Error condition 
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The 8-bit grouping of flags returned in the communications 


status code are: 


Bit Meaning 

g Clear to Send not present 

1 Unused 

2 Transmitter busy 

3 Modem data carrier not present 

4 Parity error in byte now being received 

5 Data overflow due to a byte now being 

received 

6 Framing error in a byte now being received 
7 Break Sequence now being received 


Example 

ACTL LDA 
MOVW 
MOVW 
BRK 
TESTW 
BNE 

SVC BLOCK 
RDATAB 

ACTL SVC NUMBER 
EQUW 

OPTION SWITCH 
EQUW 


-A@,SVC BLOCK 
@AG,#ACTL SVC NUMBER 
6@AG,#OPTION SWITCH 
#6 

2@A9 

ERROR 


32,2 
129 
p 
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ARCV Function Code 96 
Channel A Receive 


Returns a single character from serial channel A. 


TRSDOS-16 sets up A/BRCV, A/BTX and A/BCTL when you 
initialize channel A/B with RS232C. If you call any of 
these routines while the channel is not initialized 
(active), you will get an error return code of 1 (no 
function code exists). 


INPUT BUFFER 


Each channel (A and B) has its own internal 16-character 
receive buffer to reduce overruns when receiving data at 
high speeds. This buffer is a First-In, First-Out buffer 
(FIFO) and is established when the channel is initialized. 


When a character is received by the ARCV and BRCV SVC's, it 
is stored in this buffer along with its status when it was 
received. 


Each time a new character is received into the buffer the 
character at the top of the buffer (oldest character) is 
pushed into the character returned byte-offset and its 
Status (stored in the buffer when it was received) is pushed 
into the communications status code byte-offset. 


An overrun occurs only when the 17th character is received 
into the already-full buffer. The 16th character is 
replaced with the 17th. When the character that caused the 
overrun is retrieved into the character returned 
byte-offset, an overrun will be indicated in communication 
status code. 


If there are no characters "waiting" in the buffer, the 
communications status code will reflect the current status 
of the serial interface, 


Entry Conditions 
Byte-offset g-1 96 
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Exit Conditions 
Byte-offset 27-3 error code 
6=7 character returned (if any) 
8-9 communications status code 
19-11 character received status 


@ = character received 
non-zero = character not received 


The 8-bit grouping of flags returned in the communications 
status code are: 


Example 


ARCV 


SVC BLOCK 


Meaning 


Clear to Send not present 

Unused 

Transmitter busy 

Modem data carrier not present 

Parity error in byte now being received 
Data overflow due to a byte now being 
received 

Framing error in a byte now being received 
Break Sequence now being received 


LDA -Af,SVC BLOCK 


ARCV SVC NUMBER 


MOVW @AG,#ARCV SVC NUMBER 
BRK # 0 
TESTW 2@AD 
BNE ERROR 
RDATAB 320 
EQUW 96 
® 
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ATX Function Code 97 
Channel A Transmit 


Outputs a single character to serial channel A. 


TRSDOS-16 sets up A/BRCV, A/BTX and A/BCTL when you | 
initialize channel A/B with RS232C. If you call any of | 
these routines while the channel is not initialized 

(active), you will get an error return code of 1 (no 

function code exists). 


Data bytes will be transmitted even if no carrier is 


present. You must check the communication status code and 
character transmitted status for error conditions. 


Entry Conditions 


Byte-offset 9-1 97 
6-7 character to be sent 

Exit Conditions 

Byte-offset 2-3 error code | 
8-9 communications status code | 
19-11 character transmitted status 


@ = character transmitted 
non-zero = character not transmitted 


The 8-bit grouping of flags returned in the communications 
status code are: 


Bit Meaning 

g Clear to Send not present 

1 Unused 

2 Transmitter busy 

3 Modem data carrier not present 

4 Parity error in byte now being received * 
5 Data overflow due to a byte now being 


received * 
6 Framing error in a byte now being received * 
a Break Sequence now being received * 


* Bits 4 - 7 are only used when the character was not 
sent 
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Example 

ATX LDA 
MOVW 
MOVW 
BRK 
TESTW 
BNE 

SVC BLOCK 
RDATAB 

ATX SVC NUMBER 
EQUW 

CHAR TO SEND 
TEXT 


-A®,SVC BLOCK 


TRS-8SO * 


TECHNICAL INFORMATION 


@AQ,#ATX SVC NUMBER 


6@A9,#CHAR TO SEND 


#0 
2@AG 
ERROR 


32,8 
97 


'G 
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BCTL | Function Code 191 
Control Channel B 


Performs control functions on serial channel B and then 
returns its status. 


Entry Conditions 


Byte-offset G-1 191 
6-7 option switch 
Exit Conditions 
Byte-offset 2=3 error code 
8-9 comunication status code 


Valid option switch settings are: 


Option Meaning 
Switch 
g Get status of serial channel into 
the Status Value 
Ll Get received buffer count into the 


Status Value 
2 Turn on Request to Send (RTS) signal 
3 TRUER OL RUS 
4 Start transmission of a BREAK sequence 
5 Stop transmission of a BREAK sequence 
6 Clears receive buffer 
7 Reset SIO Error condition 


The 8-bit grouping of flags returned in the communications 
status code are: 


Bit Meaning when set 

4) Clear to Send not present 

iL Unused 

2 Transmitter busy 

3 Modem data carrier not present 
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Bit Meaning when set 
4 Parity error in byte now being received 
3 Data overflow due to a byte now being 
received 
6 Framing error in a byte now being received 
7 Break Sequence now being received 


Example 

BCTL LDA 
MOVW 
MOVW 
BRK 
TESTW 
BNE 

SVC BLOCK 
RDATAB 

BCTL SVC NUMBER 
EQUW 

OPTION SWITCH 
EQUW 


.AG,SVC BLOCK 
@AG,#BCTL SVC NUMBER 
6@AG,#OPTION SWITCH 


Radie Shaek 


136 


TRSDOS 16 OWNER'S MANUAL TECHNICAL INFORMATION 


TRS-8O ° 


BRCV Function Code 98 
Channel B Receive 


Returns a single character from serial channel B. 


TRSDOS-16 sets up A/BRCV, A/BTX and A/BCTL when you 
initialize channel A/B with RS232C. If you call any of 
these routines while the channel is not initialized 
(active), you will get an error return code of 1 (no 
function code exists). 


INPUT BUFFER 


Fach channel (A and B) has its own internal 16-character 
receive buffer to reduce overruns when receiving data at 
high speeds. This buffer is a First-In, First-Out buffer 
(FIFO) and is established when the channel is initialized. 


When a character is received by the ARCV and BRCV SVC's, it 
is stored in this buffer along with its status when it was 
received. 


Each time a new character is received into the buffer the 
character at the top of the buffer (oldest character) is 
pushed into the character returned byte-offset and its 
status (stored in the buffer when it was received) is pushed 
into the communications status code byte-offset. 


An overrun occurs only when the 17th character is received 
into the already-full buffer. The 16th character is 
replaced with the 17th. When the character that caused the 
overrun is retrieved into the character returned 
byte-offset, an overrun will be indicated in communication 
status code. 


If there are no characters "waiting" in the buffer, the 
communications status code will reflect the current status 
of the serial interface. 


Entry Conditions 
Byte-offset 9-1 98 
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Exit Conditions 

Byte-offset 2-3 
6-7 
8-9 
19-11 


TRS-SO ° 


TECHNICAL INFORMATION 


error code 

character returned (if any) 
communications status code 
character received status 

®@ = character received 

non-zero = character not received 


The 8-bit grouping of flags returned in the communication 


status code are: 


Bit Meaning 

4) Clear to Send not present 

au Unused 

2 Transmitter busy 

3 Modem data carrier not present 

4 Parity error in byte now being received 

5 Data overflow due to a byte now being 

received 

6 Framing error in a byte now being received 
Z Break Sequence now being received 


Example 
BRCV LDA .AG,SVC BLOCK 
MOVW @AG,#BRCV SVC NUMBER 
BRK # 
TESTW 2@A¥g 
BNE ERROR 
SVC BLOCK 
RDATAB 32, 
BRCV SVC NUMBER 
EQUW 98 
® 
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BTX Function Code 99 
Channel B Transmit 


Outputs a single character to serial channel B. 


TRSDOS-16 sets up A/BRCV, A/BTX and A/BCTL when you 
initialize channel A/B with RS232C. If you call any of 
these routines while the channel is not initialized 
(active), you will get an error return code of 1 (no 
function code exists). 


Data bytes will be transmitted even if no carrier is 


present. You must check the communication status code and 
Character transmitted status for error conditions. 


Entry Conditions 


Byte-offset G-1 99 
6-7 character to be sent 


Exit Conditions 


Byte-offset Z=3 error code 
8-9 communications status code 
19-11 character transmitted status 


@ = character transmitted 
non-zero = character not transmitted 


The 8-bit grouping of flags returned in the communications 
status code are: 


Bit Meaning 

g Clear to Send not present 

i Unused 

2 Transmitter busy 

3 Modem data carrier not present 

4 Parity error in byte now being received * 
5 Data overflow due to a byte now being 


received * 
6 Framing error in a byte now being received * 
Break Sequence now being received * 


* Bits 4 - 7 are only used when the character was not 
sent 
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Example 
BTX LDA .A®,SVC BLOCK 
MOVW @AG,#BTX SVC NUMBER 
MOVW 6@A®@,#CHAR TO SEND 
BRK #0 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
BTX SVC NUMBER 
EQUW 99 
CHAR TO SEND 
TEXT rG 
® 
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CLOSE 
Close Disk Files 


Terminates output to a specified file. This SVC first 
writes all unsaved data to disk, then updates the directory. 


Entry Conditions 
Byte-offset g-1 
6-7 


Exit Conditions 
Byte-offset a>3 


The file identification number is a unique number assigned 


TRS-8SO * 


Function Code 42 | 


42 
file identification number 


error code 


to each file when it is opened. | 


Example 


In this example the file identification number was 
previously stored in register Al. 


CLOSE LDA 


SVC BLOCK 
RDATAB 
CLOSE SVC NUMBER 
EQUW 


-A@,SVC BLOCK 
@AS,#CLOSE SVC NUMBER 
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CLOSEF Function Code 133 
Close Files 


Closes all open files, except for a currently executing 
DO-file, SPOOL file, or a file opened by OPENDO. 


Entry Conditions 
Byte-offset 9-1 133 


Exit Conditions 


Byte-offset 2-5 error code 
Example 
CLOSEF LDA -A~,SVC BLOCK 
MOVW @AG,#CLOSEF SVC NUMBER 
BRK # 
TESTW 2@AR 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
CLOSEF SVC NUMBER 
EQUW 265 
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CLRXIT Function Code 257 
Clear User Memory and Jump to TRSDOS-16 


Clears (writes binary zeroes) to user memory, then gives 
control to TRSDOS-16 Ready. If used with a DO-File, control 
proceeds to the next command in the DO-File. 


Entry Conditions 
Byte-offset G-1 257 


Exit Conditions 


Byte-offset 2=3 error code 
Example 
CLRXIT LDA -AS,SVC BLOCK 
MOVW @AG,#CLRXIT SVC NUMBER 
BRK # 0 
SVC BLOCK 
RDATAB 32,9 
CLRXIT SVC NUMBER 
EQUW 257 
® 
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CURSOR Function Code 19 
Position Cursor 


Positions the cursor to specified screen coordinates. This 
routine treats ROW and COLUMN as Modulo 24 and Modulo 8, 
respectively. 


Entry Conditions 


Byte-offset G-1 19 
6-7 row to position cursor 
8-9 column to position cursor 
Exit Conditions 
Byte-offset 223 error code 
Example 
CURSOR LDA -AZ,SVC BLOCK 
MOVW @AG,#CURSOR SVC NUMBER 
MOVW 6@AG,#ROW POSITION 
MOVW 8@AG,#COLUMN POSITION 
BRK # 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,2 
CURSOR SVC NUMBER 
EQUW 1g 
ROW POSITION 
EQUW fe 
COLUMN POSITION 
EQUW 49 
® 
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DATE Function Code 45 
Return Date String 


Returns the time and date as a 26-byte ASCII string with 
eight fields. 


CONTENTS OF TIME/DATE STRING (SAMPLE) 


NAME OF MON. DAY OF YEAR DAY OF TIME MON. DAY 
DAY MON. YEAR # OF WEEK 
For example: 
SATAPR28197911813.29.42945 

represents the data "Saturday, April 28, 1979, the 118th day 
of the year, 13:28:42 hours, the fourth month of the year, 
the fifth day of the week". 

Monday is considered day @. The date calculations are based 


on the Julian Calendar. 


Entry Conditions 


Byte-offset g-1 45 
6-9 address of 26-byte buffer 
Exit Conditions 
Byte-offset a error code 
Example 
DATE LDA -Ag,SVC BLOCK 
MOVW @AG,#DATE SVC NUMBER 
LDA -Al,DATE BUFFER 
STL .Al,6@AQ 
BRK #9 
TESTW 2@AGD 
® 
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BNE ERROR 
SVC BLOCK 
RDATAB 32,8 
DATE SVC NUMBER 
EQUW 45 
DATE BUFFER 
RDATAB 26,0 
® 
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DEBUG Function Code 259 
Load the Debugger 


Turns the debugger on and off. This call is valid only if 
DEBUG was configured. See Appendix B of this section for 
more information on the Configuration Command File. 


Entry Conditions 
Byte-offset G-1 259 
6-7 function code 


Exit Conditions 
Byte-offset 2=>3 error code 


Valid function codes are: 


| FUNCTION CODE FUNCTION 

iis g  _—«*«|s urns DEBUG off 
a re ie Turns DEBUG on 
als Enters DEBUG 


If you use function code 2, the Debugger will load with the 
PC register set to the current instruction address plus two. 


Example 
DEBUG LDA .AZ,SVC BLOCK 
MOVW @AG,#DEBUG SVC NUMBER 
MOVW 6@A8,#DEBUG ON 
BRK #0 
TESTW 2@AG 
BNE ERROR 
® 
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SVC BLOCK 

RDATAB 
DEBUG SVC NUMBER 

EQUW 
DEBUG ON 

EQUW 


TRS-80 ° 
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DIRRD Function Code 35 
Direct Read 


Reads a specified record of an FLR (fixed-length record) 
file. 


If you have a VLR (variable-length record) file, you can use 


DIRRD to read only the first record (@) or the end of file 
(-l). 


Entry Conditions 


Byte-offset G-1 35 
6-7 file identification number 
8-11 record buffer address 
12-15 record number 
© = position to beginning of file 
H'FFFFFFFF = position to end of file 
16 record lock flag 


Exit Conditions 
Byte-offset 2-3 error code 


The file identification number is a unique number assigned 
to each file when it is opened. 


The record buffer address is a 32 bit address that points 
to the beginning of a 256-byte Record Buffer; that is where 
the record will be placed after the disk read. 


The record number is a 32 bit number specifying the 
desired record number. 


If the record lock flag is non-zero, the specified record 
remains locked until the user program performs an UNLOCK on 
the record. 


If the record lock flag is zero, the record is not locked. 
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TECHNICAL INFORMATION 


Before executing this program, store the File Identification 
Number in register Al and the Record Number in register A3. 


READ 


SVC BLOCK 


DIRRD SVC 


RDATAB 
NUMBER 
EQUW 


RECORD BUFFER 


RDATAB 


-Ag,SVC BLOCK 


@AG,#DIRRD SVC NUMBER 


-Al,6@A% 


-A2,RECORD BUFFER 


-A2,8@AR 


-A3,12@A% 


256,29 


Radie Shaek 


159 


TRSDOS 16 OWNER'S MANUAL 


DIRWR 
Direct Write 
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Functon Code 44 


Writes a specified record in an FLR (fixed length record) 


file. 


With a VLR (variable length record) files, you can use DIRWR 
to write only the first record (f) or the end of the file 


io i Be 


Entry Conditions 

Byte-offset O@-1 
6-7 
8-11 
12-15 


44 


file identification number 
record buffer address 
record number 


§ = position to beginning of file 


H'FFFFFFFF = position to end of file 


Exit Conditions 


Byte-offset 23 error code 


The file identification number is a unique number assigned 
to each file when it is opened. 


The record buffer address is a 32-bit address that points 
to the beginning of a 256-byte Record Buffer; that is where 
the record will be placed after the disk read. 


The record number is a 32-bit number specifying the 
desired record number. 


Example 
Before executing this program, store the Identification 
Number in register Al, Record Address in register A2, and 
Record Number in register A3. 

LDA 
MOVW 


WRITE -Af,SVC BLOCK 


@AG,#DIRWR SVC NUMBER 
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SVC BLOCK 
RDATAB 
DIRWR SVC NUMBER 
EQUW 
RECORD BUFFER 
RDATAB 


-Al,6 


-A2,RECORD BUFFER 


.A2,8 


256,20 


TRS-8SO * 


CAP 


@AG 
2@AG 
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DISMOUNT Function Code 139 
Dismount Disk 


Logically disconnects a MOUNTed disk device. This command 
is valid for drives §-3 and 5-7 for hard disk users and 
drives 1-3 for floppy disk users. The system disk may not 
be DISMOUNTed. 


A DISMOUNT/MOUNT sequence is required for each diskette 
swap. (see Chapter 1) 


You should make sure all files are closed before executing a 
DISMOUNT/MOUNT sequence 


Entry Conditions 
Byte-offset 9-1 139 
6-9 device name 


Exit Conditions 


Byte-offset Z*3 error code 
Valid device names are: FD0@ = floppy drive Q 
FD@1 = floppy drive l 
FD@2 = floppy drive 2 
FD@3 = floppy drive 3 
HD@@ = hard drive 4 
HD@1 = hard drive 5 
HD@2 = hard drive 6 
HD@3 = hard drive 7 
Example 
DISMNT LDA -A@,SVC BLOCK 
MOVW @AS,#DISMNT SVC NUMBER 
LDA. -Al,DEVICE NAME 
MOVL 6@AG, GAL 
BRK # B 
TESTW 2@AG 
BNE ERROR 
® 
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SVC BLOCK 
RDATAB 32,0 
DISMNT SVC NUMBER 
EQUW 139 
DEVICE NAME 
TEXT "FDP1' 
® 
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DOSCMD Function Code 279 
Execute TRSDOS-16 Command 


Passes a command string to the TRSDOS-16 Ready mode for 
execution. After execution is complete, control returns to 
TRSDOS-16 Ready. 

This command alters the buffer used by the MOVBUF SVC. 

When chaining programs, do not use DOSCMD to execute the 
programs. Use EXECUT instead. 


Entry Conditions 


Byte-offset g-1 270 
6-7 length of string 
8-11 address of string 
Exit Conditions 
Byte-offset Z=3 error code 
Example 
DOSCMD LDA -A®@,SVC BLOCK 
MOVW @AG,#DOSCMD SVC NUMBER 
MOVW 6@AG,#STRING LENGTH 
LDA -Al,STRING 
STL .Al,8@AG 
BRK # 
SVC BLOCK 
RDATAB 320 
DOSCMD SVC NUMBER 
EQUW 270 
STRING LENGTH 
EQUW = 
STRING 
TEXT ‘DER 3 
® 
Radie Shaek 


155 


TRSDOS 16 OWNER'S MANUAL ; TECHNICAL INFORMATION 
TRS-8O 


DUMP Function Code 139 
Dump Memory to Disk 


Writes a 6880@ format program from memory to diskette. The 
Dump replaces any existing file with the same name. 


Entry Conditions 


Byte-offset G-1 139 
6-9 filespec_ address 
19-13 start dump address 
14-17 end dump address 
18-21 relocation address 
22-25 transfer Address 


Exit Conditions 
Byte-offset 2=3 error code 


filespec address specifies the memory location Of 4 
Standard TRSDOS-16 file specification. The filename is an 
ASCII string terminated by a carriage return. 


start dump address and end dump address are the 
beginning and ending locations in memory where the program 


resides. 


relocation address is the starting location where you want 
the file to load. If you don't want to relocate the file, 
set the relocation address at @. 


transfer address is the program entry point (the address 
of the first instruction to execute). If you specify a 
relocation address, this address offsets the transfer 
address. 


Note: all addresses must be an even value. 


Example 


DUMP LDA -Af,SVC BLOCK 
MOVW @AS,DUMP SVC NUMBER 
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LDA -Al,FILE NAME 
STL .Al,6@AQ 
MOVL 1G@A9,#START AND TRANS ADDRESS 
MOVL 14@A@,#END DUMP ADDRESS 
MOVL 18@A@,#RELOCATION ADDRESS 
MOVL 22@A9,#START AND TRANS ADDRESS 
BRK # 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 325.0 
DUMP SVC NUMBER 
EQUW 139 
FILE NAME 
TEXT 'TEST/SRC! 
DATAB H'@D 
START AND TRANS ADDRESS 
EQUL H' 60022 
END DUMP ADDRESS 
EQUL H' 60000 
RELOCATION ADDRESS 
EQUL 4) 
® 
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ERRMSG Function Code 52 
Error Message 


In response to a requested error number, this routine 
returns an 8f@-byte descriptive error message to a specified 
buffer area. 


Entry Conditions 


Byte-offset 6-1 52 
6-7 error number 
8-11 message buffer address 


Exit Conditions 
Byte-offset 2=3 error code 


The error number range is @ to 255, inclusive. 


Example 
ERRMSG LDW -Al,2@AG 
LDA -Af,SVC BLOCK 
MOVW @AG,#ERRMSG SVC NUMBER 
STW .Al,6@AQ 
LDA -Al,MESSAGE BUFFER 
STL -Al,8@AQ 
BRK # @ 
TESTW 2@AR 
BNE JP2DOS 
CALL VIDEO PRINT LINE ROUTINE 
SVC BLOCK 
RDATAB 32,0 
ERRMSG SVC NUMBER 
EQUW 5 
MESSAGE BUFFER 
RDATAB 80,0 
® 
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TECHNICAL INFORMATION 


Function Code 39 


Displays the message ERROR followed by the specified error 


code at the current cursor position. 


Entry Conditions 


Byte-offset 


Exit Conditions 


Byte-offset 


O-1 
S-7 


ZS 


39 
error number 


error code 


The error number is a @ - 255 code of the message you want 


displayed. 


Example 


ERROR 


SVC BLOCK 


ERROR SVC 


RDATAB 
NUMBER 
EQUW 


-Al,2@AQ 
-Af,SVC BLOCK 


@A@,#ERROR SVC NUMBER 


2@AG 
JP2DOS 


32,8 
39 
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EXECUT 
Execute Program 


Entry Conditions 

Byte-offset G-1 
6~-7 
8-11 


Exit Conditions 
Byte-offset a3 


Example 


EXECUTE LDA 


SVC BLOCK 
RDATAB 
EXECUTE SVC NUMBER 
EQUW 
FILENAME 
TEXT 
DATAB 


TRS-SO * 


Function Code 263 


Begins program execution in user memory. 


263 
02 (Reserved) 


filespec address 


error code 


The filespec address is the 32-bit address of a valid 
TRSDOS-16 filespec terminated by a carriage return. 


-Af,SVC BLOCK 
@AG,#EXECUTE SVC NUMBER 


6@AD, #09 
.Al, FILENAME 
.Al,8@AG 

#0 

2@AG 

JP2DOS 


32,2 
263 


'TEST/CMD' 
H'@D 
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HLDKEY Function Code 29 
Enable Hold Key 


Suspends and restarts terminal output whenever you press the 
<HOLD> key. 


This SVC must first be enabled. Then you must periodically 


call HLDKEY to check if the <HOLD> key has been depressed. 
This places the program in control of the pause checking. 


Note that execution of certain DOSCMDs might alter the 
HLDKEY status. This will happen if the TRSDOS-16 command 
issues HLDKEY requests. 


Entry Conditions 
Byte-offset J-1 29 
oheae function code 


Exit Conditions 
Byte-offset 2-3 error code 


The HLDKEY function codes are: 


Code Meaning 
g Turn off HOLD processor. Pressing <HOLD> 
generates H'9@'. 
1 Turn on HOLD processor. <HOLD> key doesn't 


generate keyboard data, it is intercepted 
by TRSDOS-16. 
2 Check for <HOLD> key. If pressed, wait until 


pressed again. 


Example 
HLDKEY LDA .AZ,SVC BLOCK 
MO VW @AM,#HLDKEY SVC NUMBER 
MO VW 6@A0,#HOLD KEY FUNCTION CODE 
® 
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BRK 
TESTW 
BNE 
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# 8 
2@AG 


ERROR 


* CHECK TO SEE IF HOLD KEY PRESSED 


LDA 
MOVW 
MOVW 
BRK 
TESTW 
BNE 


SVC BLOCK 
RDATAB 
HDLKEY SVC NUMBER 
EQUW 


-AG,SVC BLOCK 

@AS,#HLDKEY SVC NUMBER 

6@AQ,#CHECK IF HOLD KEY WAS PRESSED 
#0 


2@AG 
ERROR 


32,8 


Zu 


HOLD KEY FUNCTION CODE 


EQUW 


Af 


CHECK IF HOLD KEY PRESSED 


EQUW 


2 
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JP2DOS Function Code 264 
Jump to TRSDOS-16 


After closing all open files and performing system 
housekeeping, returns control to TRSDOS-16 Ready. 


If a program under the control of a DO-file executes this 
routine, control proceeds to the next command in the 
DO-file. 


Entry Conditions 
Byte-offset g-1 264 
6-7 @@ (Reserved) 


Exit Conditions 


Byte-offset 2-3 error code 
Example 
JP2D0S LDA -AZ,SVC BLOCK 
MOVW @AG,#JIP2DOS SVC NUMBER 
BRK # 6 
SVC BLOCK 
RDATAB 32,28 
JP2DOS SVC NUMBER 
EQUW 264 
® 
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KBCHAR Function Code 4 
Keyboard Character 


Checks the keyboard for a new character entry. 


If characters are present in the key-ahead buffer, the first 
character in the buffer will be returned in the returned 
character byte-offset. 


The <BREAK> key is masked from the user -- it will never be 
returned, since it is intercepted by the System. If a 
SETBRK routine is enabled, control passes to the processing 
program (see SETBRK) whenever <BREAK> is pressed. 
Otherwise, control will pass to TRSDOS-16 Ready. 


Entry Conditions 
Byte-offset g-1 4 


6-7 wait for character flag 


Exit Condition 


Byte-offset error code 


3 
5 character present flag 
9 returned character 


iS 
2- 
6- 
8 —- 
If you want the SVC to return only when a character is 

detected, set the wait for character flag to non-zero. A 
zero in this byte-offset causes the SVC to return, with or 


without a character, immediately after the keyboard buffer 
is checked. 


A character present flag of non-zero means the routine has 
returned with a valid ASCII character in the returned 
character position. 


If it returns without a character, (when the SVC is set not 
to wait for a character) the routine clears the character 


present flag, but doesn't change the contents of the 
returned character byte-offset. 
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Example 


This program returns the character most recently pressed and 
then calls PRINT CHARACTER ROUTINE, which uses either the 
VDCHAR or PRCHAR routines to print it. 


KBCHAR LDA -AS,SVC BLOCK 
MOVW @AS,#KBCHAR SVC NUMBER 
MOVW 6@A0,#WAIT FOR CHARACTER FLAG 
BRK 7) 
TESTW 2@AG 
BNE ERROR 
CALI PRINT CHARACTER ROUTINE 
SVC BLOCK 
RDATAB 32,0 
KBCHAR SVC NUMBER 
EQUW 4 
WAIT FOR CHARACTER FLAG 
EQUW 1 
® 
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KBINIT 3 Function Code 1 
Keyboard Initialize 


Initializes the keyboard input driver. You might want to 
call this SVC before starting keyboard input to clear 
previous keystrokes and the key-ahead buffer. TRSDOS-16 
does this automatically at start-up. 


Entry Conditions 
Byte-offset 9-1 1 


Exit Conditions 


Byte-offset Z2=3 error code 
Example 
KBINIT LDA .A@,SVC BLOCK 
MOVW @AG,#KBINIT SVC NUMBER 
BRK # 0 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,2 
KBINIT SVC NUMBER 
EQUW 1 
® 
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KBLINE Function Code 5 
Keyboard Line 


Inputs a line from the keyboard to a buffer and echoes the 
line to the Display, starting at the current cursor 
position. As it receives and displays each character, the 
routine advances the cursor to the next position. 


When you enter this routine, the input buffer contains a 
string of periods which it sends to the display. This 
string is for your convenience to indicate the length of the 
Input: field, 


The keyboard line ends when you press <ENTER> or when the 
routine fills the input buffer. When you terminate line 
input, the routine always sends a Carriage return and an 
erase-to-end-of-screen command to the Display. It stores a 
carriage return as a character input only if you actually 
press <ENTER>. 


If you type a control code not listed below, the routine 
4 \ places it in the buffer and represents it on the display 
| with the + symbol. 


jm | Be 
KEY CODE FUNCTION 
BACKSPACE 98 Backspaces the cursor and erases a 
character. 

ENTER OD Terminates line. Clears trailing 
periods on Display 

CTRL W Ly Fills remainder of input buffer with 
blanks, blanks remainder of Display line 

CTRL X 18 Fills remainder of input buffer with 
blanks, blanks to end of Display. 

ESC 1B Reinitializes input function by filling 
input buffer with periods and restoring 
cursor to Original position. 

<3 LC Backspaces the cursor to allow editing of 
line. Does not erase characters. 

-> 1D Advances the cursor to allow editing of 


line. Does nct erase characters. 


Radie Shaek 


167 


TRSDOS 16 OWNER'S MANUAL TECHNICAL INFORMATION 


TRS-8SO ° 
Entry Conditions 
Byte-offset 0-1 , 5 
6-7 maximum number of characters to 
receive (@ - 255) 
8-11 input buffer address 
Exit Conditions 
Byte-offset 23 error code 
12-13 actual number of characters input 
14-15 terminating character of input 


H'@D if line was terminated with 
a carriage return, § if buffer 
was filled without a carriage 


return 
Example 
KBLINE LDA .A®G,SVC BLOCK 
MOVW @AG,#KBLINE SVC NUMBER 
MOVW 6@AG,#MAXIMUM INPUT COUNT 
LDA .Al,KEYBD BUFFER 
STL .Al, 8@AQ 
BRK # 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
KBLINE SVC NUMBER 
EQUW 5 
MAXIMUM INPUT COUNT 
EQUW 80 
KEYBD BUFFER 
RDATAB 80,0 
® 
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KILL Function Code 41 
Delete File from Directory 


Deletes the specified file from the directory. A file must 
be closed for you to KILL it. 


Entry Conditions 


Byte-offset O-1 41 
6-9 filespec address 


Exit Conditions 
Byte-offset 273 error code 


The filespec address is the 32-bit address of a valid 
TRSDOS-16 filespec terminated by a carriage return. 


Example 
KILL LDA -AZ,SVC BLOCK 
MOVW @A9,#KILL SVC NUMBER 
LDA -Al,FILE NAME 
STL -Al,6@AG 
BRK # £ 
TESTW 2@A¥P 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
KILL SVC NUMBER 
EQUW 4] 
FILE NAME 
TEXT ‘TEST /SRC* 
DATAB H'@D 
® 
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LOAD Function Code 131 


LOAD's a 6899@ program into user memory. 


Entry Conditions 


Byte-offset G-1 131 
6-9 filespec address 
18-13 low bound address (only if 


program is position independent, 
otherwise must be zero) 

14-17 high bound address (only if 
program iS position independent, 
otherwise zero allows all of 


memory ) 
Exit Conditions 
Byte-offset 2-3 error code 
19-13 start load address 
14-1] 7 address of last byte loaded 
Le 2: transfer address 
Supply a low bounds address and high bounds address only New 


if your program does NOT have any absolute memory references. 


filespec address is the 32-bit address of a valid 
TRSDOS-16 program filespec terminated by a carriage return. 


low bounds address is the logical address you want the 
program loaded at. Specifying zero means the entire user 
memory is available. If this number is non-zero then the 
program MUST be position-independent. 


high bounds address is the logical address of the last 
byte available for the program being loaded. Specifying 
zero allows entire user memory. 


start load address is the location in memory of the first 
byte loaded. 


address of last byte loaded is the highest address of the loaded 
program. 
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transfer address is the program entry point (address of 
first instruction to be executed). If the program is 
nonexecutable ("load-only"), the byte-offset contains a -l. 


Note: all addresses must be an even valué. 


Example 
LOAD LDA -Af,SVC BLOCK 
MOVW @AG,#LOAD SVC NUMBER 
LDA .Al,FILE NAME 
STL -Al,6@AQ 
BRK # 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
LOAD SVC NUMBER 
EQUW 131 
FILE NAME 
TEXT 'TEST/SRC! 
DATAB H'@D 
® 
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LOCATE Function Code 33 
Locate Record 


Returns the number of the current record, i.e., the last 
record accessed. You can call this routine only with FLR 
(fixed-length Record) files. 


Entry Conditions 
Byte-offset G-1 33 
6-7 file identification number 


Exit Conditions 
Byte-offset 2-3 error code 
8-11 record number 


The file identification number is a unique number assigned 
to each file when it is opened. 


The record number is a 32 bit number specifying the 
current record number. The record number will be zero if 
the file was just opened. 


Example 


Prior to execution of this routine, store the file 
identification number in register Al. 


LOCATE LDA .AZ,SVC BLOCK 
MOVW @AG,#LOCATE SVC NUMBER 
STW .Al,6@AQ 
BRK # J 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
LOCATE SVC NUMBER 
EQUW 33 
® 
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MOUNT Function Code 138 
Mount Device 


Logically connects a device to the system. The system 
cannot access an unMOUNTed device. You must mount a 
diskette prior to any I/O attempts. 


A DISMOUNT/MOUNT sequence is required for each floppy 
diskette swap. 


You should make sure all files are closed before executing a 
DISMOUNT/MOUNT sequence. 


Entry Conditions 


Byte-offset G-1 138 
6-9 device name 


Exit Conditions 


Byte-offset 2-3 error code 
Valid device names are: FD@G = floppy drive 9g 
FD@1 = floppy drive 1 
FD@2 = floppy drive 2 
FD@3 = floppy drive 3 
HD@@ = hard drive 4 
HD91 = hard drive 5 
HD@2 = hard drive 6 
HD@3 = hard drive 7 
Example 
MOUNT LDA -Ag,SVC BLOCK 
MOVW @AQ,#MOUNT SVC NUMBER 
LDA -Al,DEVICE NAME 
MOVL 6@A0,@A1 
BRK # 2 
TESTW 2@AG 
BNE ERROR 
® 
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SVC BLOCK 
RDATAB 32,0 
MOUNT SVC NUMBER 
EQUW 138 
DEVICE NAME 
TEAT "FD@1' 
® 
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MOVBUF Function Code 267 
Move Buffer 


Either retrieves or stores an 8@-byte buffer outside the 
user's memory. This buffer serves two purposes: 


A ie To paSs parameters when chaining two machine 
language programs. 


(When chaining programs, do not use DOSCMD to 
execute the programs. Use EXECUT instead, ) 


2s To retrieve a TRSDOS-16 command line. When 
TRSDOS-16 starts a user program, it stores the command 
line that invoked the job in this area. 


(When TRSDOS-16 stores a command line it 
terminates it with a carriage-return character. 
However, when MOVBUF retrieves a command line 
88 characters long, it does not retrieve the 
carriage return, implied 8lst character.) 


There are two ways to alter this buffer: 

1. A MOVBUF request from memory to buffer overwrites 
anything in the buffer. Note that 8@ bytes (58 Hex 
bytes) are always moved. 

2. A DOSCMD request does an implied move into the 


buffer before executing the request. Anything 
previously stored in the buffer is lost. 


Entry Conditions 


Byte-offset O-1 267 
6-9 user buffer address 
19-11 switch 


@ = Retrieve 
non-zero = Store 


Exit Conditions 
Byte-offset 2-3 error code 
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Example 
MOVBUF LDA -A®,SVC BLOCK 
MOVW @AS,#MOVBUF SVC NUMBER 
LDA -Al, BUFFER 
STL -Al,6@AQ 
MOVW 19@AQ,#FETCH SWITCH 
BRK # 6 
TESTW 2@A¥G 
BNE ERROR 
SVC BLOCK 
RDATAB 32,20 
MOVBUF SVC NUMBER 
EQUW 267 
BUFFER 
RDATAB 80,0 
FETCH SWITCH 
EQUW 4) 
® 
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OPEN Function Code 49 
Open File 


Creates new files and opens existing files. 


Once a given file has been opened, OPEN assigns a unique 
file identification number to the file. This number is 
used in all other file processing SVC's to designate that 
specific file. 


Entry Conditions 


Byte-offset g-1 4G 

6-9 filespec address 

19-13 parameter list address 
Exit Conditions 
Byte-offset aa error code 

14-15 file identification number 


The filespec address is the 32-bit address of a valid 
TRSDOS-16 filespec terminated by a carriage return. 


The parameter list address is the address of a 5-bytes 


field (@-4) which contains: 


Byte Contents 
QO access code 


"R" Read access to the file 

"W" Read/Write (data files) 

"Pp" Read/Write access to Z8% program 
files 


G1 record length in bytes 
@2 file type 
Ke fixed 
"VZV" variable 
63 creation code (9-3 -- see table) 


94 user attribute byte 
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The creation code specifies the way TRSDOS-16 opens the 
file: 


Code Function 


-TECHNICAL INFORMATION 


4) Open the file only if it already exists. Do 
not create a new file. The record length and 
end of file pointers are not reset. Exclusive 
access only. 


a Creates a new file. Does not open an existing 
file (returns an error if a file of the 
same name already exists on the specified 
drive). Resets the record length and end of 
file. Exclusive access only. 


2 Open a new file. If a file of the same name 
already exists, overwrite it. Resets record 
length and end of file. Exclusive access 
only. 


3 Opens an existing file for shared access. The 
file MUST already exist (same as mode Q). 


The user attribute byte allows you to give your own 
identification number to certain types of data files. 


You can use @ or any number from 32 - 255 for this value. 


TRSDOS-16 will not examine this user attribute; it is 
solely for your convenience. 


You can asSign this user attribute only to files you open 
with a creation code of 1 or 2. Files opened with a 
creation code of @ or 3 will retain the file's previously 
assigned user attribute. All files created with the 
CREATE command will have a user attribute value of zero. 


The file identification number is a unique number 
assigned to each file when it is opened. 
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Example 


OPEN LDA 


SVC BLOCK 

RDATAB 
OPEN SVC NUMBER 

EQUW 
FILE NAME 

TEXT 

DATAB 
PARAM LIST 

RDATAB 
WRITE ACCESS 

EQUB 
RECORD LENTGH 

EQUB 
FIXED FILE 

EQUB 


OPEN ONLY IF EXISTS 


EQUB 
USER ATTRIB 
EQUB 
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-Af,SVC BLOCK 


TECHNICAL INFORMATION 


@AG,#OPEN SVC NUMBER 


-Al,FILE NAME 
-Al,6@AQ 
-Al,PARAM LIST 


@Al,#WRITE ACCESS 
1@Al,#RECORD LENGTH 


2@A1,#FIXED FILE 


3@A1,#OPEN ONLY IF EXISTS 


4@al,#USER ATTRIB 


.Al,1@@AG 
#0 

2@AG 
ERROR 


32,2 
49 


'TEST/SRC* 
H'@D 


5,8 
PP 


89 


66 
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OPENDO Function Code 149 
Open DO File 
Creates a special file or opens an existing one. 


OPENDO opens a Special file that will not be closed by 
returning to TRSDOS-16 Ready or executing the CLOSEF SVC. 


OPENDO is useful for chaining programs. 


Once a given file has been opened, OPENDO assigns a unique 
file identification number to the file. This number is 
used in all other file processing SVC's to designate that 
specific file. 


Only one file may be opened with OPENDO at a time. 
Therefore, this call cannot be made if a DO file is active. 


Entry Conditions 


Byte-offset G-1 149 
6-9 filespec address 
19-13 parameter list address 


Exit Conditions 
Byte-offset 2-3 error code 
14-15 file identification number 


The filespec address is the 32-bit address of a valid 
TRSDOS-16 filespec terminated by a carriage return. 


The parameter list address is the address of a 5-bytes 
field (@-4) which contains: 


Byte Contents 


0D access code 
"RY “Read access to the file 
"Ww" Read/Write (data files) 
"Dp" Read/Write access to Z8@ program 
files 
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Byte Contents 


@1 record length in bytes 
G2 file type 


ne" 6 FE ved 
"V" variable 
3 creation code (@-3 -- see table) 


@4 user attribute byte 


The creation code specifies the way TRSDOS-16 opens the 


file: 


Function 


Open the file only if it already exists. Do 
not create a new file. The record length and 
end of file pointers are not reset. Exclusive 
access only. 


Creates a new file. Does not open an existing 
file (returns an error if a file of the 

Same name already exists on the specified 
drive). Resets the record length and end of 
file. Exclusive access only. 


Open a new file. If a file of the same name 
already exists, overwrite it. Resets record 
length and end of file. Exclusive access 
only. 


Opens an existing file for shared access. The 
File MUST already exist (same as mode Q@). 


The user attribute byte allows you to give your own 
identification number to certain types of data files. 


You can use @ or any number from 32 - 255 for this value. 


TRSDOS-16 will not examine this user attribute: it is 
solely for your convenience. 


You can assign this user attribute only to files you open 
with a creation code of 1 or 2. Files opened with a 
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creation code of @ or 3 will retain the file's previously 


assigned user attribute. 


All files created with the 


CREATE command will have a user attribute value of zero. 


The file identification number is a unique number assigned 
to each file when it is opened. 


Example 


OPENDO LDA 


SVC BLOCK 
RDATAB 
OPENDO SVC NUMBER 
EQUW 
FILE NAME 


PARAM LIST 
RDATAB 
WRITE ACCESS 
EQUB 
RECORD LENTGH 
FQUB 
FIXED FILE 
EQUB 


OPEN ONLY IF EXISTS 


EQUB 
USER ATTRIB 
EQUB 


.A@,SVC BLOCK 
@AG,#OPENDO SVC NUMBER 
.Al,FILE NAME 

.Al,6@A9 

.Al,PARAM LIST 
@Al,#WRITE ACCESS 
1@Al1,#RECORD LENGTH 
2@Al1,#FIXED FILE 
3@Al1,#OPEN ONLY IF EXISTS 
4@al,#USER ATTRIB 

.Al, 1G@AG 

#2 

2@Ag 

ERROR 


32,2 
149 


"TEST / SRC" 
H'@D 


578 
'p 


89 


66 
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PRCHAR Function Code 18 
Print Character 


Sends one character to the Printer's buffer. 


Note: Most printers don't print until their buffer is 
filled or until they receive a carriage return. (See your 
printer's manual for information. ) 


Normally, TRSDOS-16 intercepts certain codes and does not 
send them directly to the printer. There are several ways 
to override some or all of these character translations. 
see PRINIT and PRCTRL SVCs. 


While the serial printer option is selected, allowing 
printer output to Channel B, two INPUT characters are 
recognized from Channel B. These will affect all serial 
printer output operations: 


ASCII Hex 

Name Code Result 

DGS. "“CTRL=s” i3 Pause Printing 
Ded, “CTRL-o" 11 Resume Printing 


INTERCEPTED CODES 


ASCII HEX 

NAME: CODE RESULT TO PRINTER 
Tab 99 From one to eight spaces are sent 

to provide a tab function. 

Vertical OB Same as form feed below. 

Tab 
Form gC TRSDOS-16 sends enough carriage 

Feed returns or line feeds to the 


printer to advance the paper to the 
next top of form. 
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ASCII HEX 
NAME CODE RES Ao TO BRIN oR 
Carriage | @D | When the current line is empty, (no 
Return characters printed since the last 


carriage return or line feed), 
TRSDOS-16 translates this as a 
line feed to allow correct 
operation of Radio Shack pene es 
In the auto line feed mode, H'QA' 
is sent after every H'@D'. 
Special 8D TRSDOS-16 sends a carriage return 
to the printer... In the. auto.dine 
feed mode, using this code allows 


you to send a carriage return 
without a line feed. 


ume SS) teomns mamma On “AUER OME) OREO TOUS CE SA AD ON AD ANY SY SONS ED NS SN NS NY ND AES REY ED “SND SS SEND SD SO ED 


Entry Conditions 


Byte-offset g-1 18 
6-7 character to. outpuc 
Exit Conditions 
Byte-offset Zr3 error code 
Example 


Before executing this program, load register Al with the 
character from byte-offset 8 of the KBCHAR SVC routine. 


PRCHAR LDW .Al,8@AQ 
LDA .AZ,SVC BLOCK 
MO VW @AG,#PRCHAR SVC NUMBER 
STW .Al,6@AG 
BRK #9 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,9 
PRCHAR SVC NUMBER 
EQUW 18 
® 
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PRCTRL Function Code 95 
Control Printer Operation 


Provides you with various printer options and lets you check 
the status of printer-related functions. 


If you are using the spooler's capture function, the 
captured data is sent directly to the capture-file -- 
regardless of what control settings are selected. If you 
are using the spooler's background printing function, the 
printed data is interpreted according to the currently 
selected control settings. See SPOOL for details. 


You can operate with two printers, by switching between the 
serial and parallel output modes. One printer can use the 
automatic control features of TRSDOS (auto form feed, etc.), 
while the other printer is controlled by the program. This 
is necessary since only one set of control counters is 
maintained. 


Entry Conditions 


Byte-offset G-1 95 
6-7 option code (See Table 2) 
8-9 option value (applicable only with 


option codes 3 and 4) 


Exit Conditions 


Byte-offset 253 error code 
19-11 physical page length 
12-13 logical page length 
14-15 logical line length 
16-17 number of characters printed on 
present line 
18-19 number of lines on present page 


The option code is a 16-bit value used to select the print 
control option you wish. 


The option value is used by option codes 3 and 4 which 


allow you to reset the current line count or the current 
character count. Put the new values in this byte-offset. 
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Available option codes are: 


CODE OPTION 
g Get printer status only (see Exit Conditions) 
1 Select serial printer driver (you must initialize 
channel B first) 


2 Select parallel printer driver 

3 Reset current line count to the value contained in 
option value * 

4 Reset current character count on current line to value 


contained in option value * 
5 Begin transparent mode * 
6 End transparent mode * 
7 Begin dummy mode * 
8 End dummy mode *% 
9 Begin auto line-feed after carriage return * 
4) End auto line-feed after carriage return * 


* EXPLANATION OF OPTIONS 


EXPLANATION OF OPTIONS 


Serial/Parallel Printer Option 

While the serial printer option is selected, allowing 
printer output to Channel B, two INPUT characters are 
recognized from Channel B. These will affect all serial 
printer output operations: 


ASCII Hex 

Name Code Result 

DCS; “CTRiHs* Lo Pause Printing 
Del; "CERL=O" A Resume Printing 


Line count/Character count 
TRSDOS-16 maintains a single line counter and a single 
character counter. 
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Transparent Mode 


The transparent mode overrides all data translation. All 
data bytes go directly to the printer; TRSDOS-16 does not 
examine the contents or update the line and character 
counts. 


Normally, TRSDOS-16 "intercepts" certain control characters 
and interprets them. In this way, TRSDOS-16 provides 
printer-related features which may not be available from the 
printer. 


For example, tabs (H'9#9') are intercepted so that TRSDOS-16 
can send the appropriate number of spaces to provide the tab 
function. Form feeds (H'#C' or H'@B') are intercepted so 
that TRSDOS-16 may advance the paper to the top of the next 
form. 


Special settings of the printer initialization values can 
Override individual code translation. See SVC PRINIT for 
details. 


Dummy Output Mode 


The dummy mode "throws away" all printer output and returns 
with a "good" (Z flag set) return code. During dummy mode 
operation, the line count and character count remain 
unchanged. 


Auto Line Feed 

Normally, the TRSDOS-16 printer driver doesn't output line 
feeds after carriage returns because most Radio Shack 
printers do an automatic line-feed after every carriage 
return. 


If your printer does not perform automatic line-feeds after 


carriage returns, you may enable the TRSDOS-16 auto 
line-feed function. 


While the function is enabled, TRSDOS-16 outputs a line-feed 
after each carriage return. This is true in all modes, 
including the transparent mode. 


Note: In the auto line-feed mode, you can send a carriage 
return with no line-feed by outputting the code H'8D'. If 
the printer can overprint, this code returns the carriage 
without advancing the paper. 
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PRECEDENCE OF OPTIONS 


The priority of the available options are (in descending 
order): 


Dummy Mode 

Auto Line-Feed after Carriage Return 
Transparent Mode 

Normal Mode 


Example 
PRCTRL LDA -A@,SVC BLOCK 
MOVW @AS,#PRCTRL SVC NUMBER 
MOVW 6@AG,#GET STATUS OPTION 
BRK # £ 
TESTW 2@AP 
BNE ERROR 
SVC BLOCK 
RDATAB 32,2 
PRCTRL SVC NUMBER 
EQUW ID 
GET STATUS OPTION 
EQUW 4) 
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PRINIT Function Code 17 
Printer Initialization 

Initializes the printer driver. 

It does not advance the printer paper and does not check 


printer status or availability. It will operate even if the 
printer is offline. 


Entry Conditions 


Byte-offset O-1 Ly 
6-7 physical page length 
8-9 logical page length 
1@-11 logical line length 


Exit Conditions 
Byte-offset Zn3 error code 


physical page length is the number of lines that can be 
printed on one page. It is normally 66. 


logical page length is the number of lines you want printed 
on each page. It must be less than physical page length. 
After that number of lines has been printed, (logical page 


length < physical page length) TRSDOS-16 will send a 
top-of-page request to the printer (form feed). 


logical line length is the maximum number of characters to 
be printed on each line. Once that number has been reached, 
the line will be printed and a new line is begun 
(wrap-around). 


Notes: 


1. If logical page length and physical page length are 
equal and non-zero, TRSDOS-16 will not do an end-of-page 
skip. It will translate form feed into the correct number 
of line feeds necessary to get to the top of the next 


page. 
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If either logical page length or physical page length 
are zero, the other must also be zero. When both are 


equal to zero, form feeds (H'@C) and vertical tabs (H'Q@B) 
are not translated into line feeds, but are sent directly 
to the printer. 


If logical line length is zero, then tab characters 
(H'@9) will not be translated into spaces, but sent 
directly to the printer. TRSDOS-16 will still maintain 
an internal character count, with tabs counting as one 
character. 


On Exit, current character count and line-in-page count 
are reset to zero. 


TRSDOS-16 assumes the printer is at top-of-page when 
this SVC is executed. 


DUMMY and TRANSPARENT modes are reset to NORMAL. 
AUTO-LINEFEED and DUAL options are unaffected by this 
SVC. (See PRCTRL) 


When the system is powered-up or reset, the following 
defaults are assumed: 


physical page length 
logical page length 
logical line length 


Hou Wl 
op) 
.] 


The other options selected during initialization are: 


Orr 
off 
OLE 


Auto-Line Feed 
Dummy Mode 
Transparent Mode 


Example 


PRINIT LDA -Af,SVC BLOCK 


MOVW @AG,#PRINIT SVC NUMBER 
MOVW 6@A8,#PHY PAGE LENGTH 
MOVW 8@AG,#LOG PAGE LENGTH 


MOVW 1@@A0,#LOG LINE LENGTH 
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BRK # G 
TESTW 2@GAG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,8 
PRINIT SVC NUMBER 
EQUW 7 
PHY PAGE LENGTH 
EQUW 32 
LOG PAGE LENGTH 
EQUW 39 
LOG LINE LENGTH 
EQUW 45 
® 
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PRLINE Function Code 19 
Print Line 


Sends a line of characters to the printer's buffer. The 
line can include control characters as well as printable 
data. 


See PRCHAR for a listing of intercepted codes. 


Entry Conditions 


Byte-offset G-1 19 
6-7 length of line (§-255) 
8-9 terminator character to send after 


last character in buffer 
19-13 address of buffer 


Exit Conditions 
Byte-offset Z=3 error code 


Example 
In this example, TRSDOS-16 retrieves the length of line, 


terminator character, and address of buffer from the KBLINE 
SVC routine. 


LDW .Al,12@A@ *Get length of line 
LDW -A2,14@A® *Get terminator character 
LDA .A3,KEYBD BUFFER *Get buffer address 
PRLINE LDA -AZ,SVC BLOCK 
MOVW @AG,#PRLINE SVC NUMBER 
STW -Al,6@AQ 
STW -A2,8@AP% 
STL .A3,10@AP 
BRK # B 
TESTW 2@AG 
BNE ERROR 
® 
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SVC BLOCK 
RDATAB 32.0 
PRLINE SVC NUMBER 
EOQUW 19 
® 
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READNX Function Code 34 
Read Next Record 


Reads the next record after the current record (the last 
record accessed). If you have just opened the file, READNX 
reads the first record. 


Entry Conditions 


Byte-offset G-1 34 
6-7 file identification number 
8-11 record buffer address 
12-13 record lock flag 


Exit Conditions 
Byte-offset 233 error code 


The file identification number is a unique number assigned 
to each file when it is opened. 


The record buffer address is a 32-bit address that points 
to the beginning of a 256-byte Record Buffer; that is where 
the record will be placed after the disk read. 


If the record lock flag is non-zero, the specified record 
remains locked until the user program performs an UNLOCK on 
the record. 


If the record lock flag is zero, the record is not locked. 


Example 


Prior to this routine, store the file identification number 
in register Al. 


READNX LDA .AS,SVC BLOCK 
MOVW @AS,#READNX SVC NUMBER 
STW -Al, 6@AQ 
LDA -A2,RECORD BUFFER AREA 
STL .A2,8@AG 
® 
Radio Shaek 


194 


TRSDOS 16 OWNER'S MANUAL TECHNICAL INFORMATION 


TRS-80 ° 
BRK # J 
TESTW 2@GAG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
READNX SVC NUMBER 
EQUW 34 
RECORD BUFFER AREA 
RDATAB 256,20 
® 
Radice Shaek 


LoD 


TRSDOS 16 OWNER'S MANUAL as TECHNICAL INFORMATION 
TRS-8O 


RENAME Function Code 47 
Rename File 

Changes the name and/or extension of a file. 

This SVC cannot change the password. If the old filespec is 
password protected, you must specify the password and the 


new filespec retains the same password. 


The new filespec can't refer to an existing file. 


Entry Conditions 


Byte-offset O-1 47 
6-9 old filespec address 
19-13 new filespec address 


Exit Conditions 
Byte-offset ZA3 error code 


The filespec address is the 32-bit address of a valid 
TRSDOS-16 filespec terminated by a carriage return. 


Example 
RENAME LDA -A@,SVC BLOCK 
MOVW @AS,#RENAME SVC NUMBER 
LDA .Al,OLD NAME 
ST .Al,6@AG 
LDA .Al,NEW NAME 
STL Al, 1#@Ag 
BRK #0 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
RENAME SVC NUMBER 
EQUW 47 
® 
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OLD NAME | 
TEXT 'TEST/SRC'! 
DATAB H'@D 
NEW NAME 
TEXT "PROGRAM/SRC! 
DATAB H'@D 
® 
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RESET | Function Code 129 
Reset Memory 


It is the same as pressing the RESET switch. 


Reset will not close an OPENDO file. 


Entry Conditions 
Byte-offset 9-1 256 
6-7 08 (Reserved) 


Exit Conditions 


Byte-offset 23 error code 
Example 
RESET LDA -Ag,SVC BLOCK 
MOVW @AG,#RESET SVC NUMBER 
MOVW 6@AD, #09 
BRK #0 
SVC BLOCK 
RDATAB 32,0 
RESET SVC NUMBER 
EQUW 129 
® 
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RS232C Function Code 55 
Initialize RS-232-C Channel 


Sets up or disables either channel A or B. 


This routine sets the standard RS-232C parameters, and 
defines a pair of supervisor calls for I/O to the specified 
Channel. When you initialize Channel A, SVC's 96, 97, 199 
are defined; when you initialize Channel B, SVC's 98, 99, 
and 191 are defined. See ARCV, ATX, BRCV, BTX, ACTL and 
ed ig 


Entry Conditions 
Byte-offset G-1 55 
6-7 option value 
®@ = deactivate 
non-zero = activate 


8-11 parameter list address 
Exit Conditions 
Byte-offset a3 error code 


Set the option value to @ to deactivate the serial 

Channel. Any non-zero value activates the channel. You 
must always deactivate the channel (turn it off) before you 
set the parameters. 


The parameter list address is the address of a 6-byte 
field (8-5) which contains: 


Byte Contents 
3%) Channel code 'A' or 'B' (ASCII) 
G1 Baud Rate: 
1 = 19% baud 
2= 159 baud 
3 = 399 baud 
4 = 699 baud 
5 = 1209 baud 
6 = 2408 baud 
7 = 4898 baud 
8 = 9699 baud 
® 
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Some applications do not run well at the 
higher baud rates. 


G2 Data Word Length (5 - 8 bits) 
63 Parity “E* (even), ‘O° todd}, or "N* (none) 
g4 Number of stop bits (1 or 2) 
65 End of list marker (binary Q) 
Example 
KS232C LDA -Ag,SVC BLOCK 
MOVW @AG,#RS232C SVC NUMBER 
LDA -Al,PARAM LIST 
MOVW @A1l,#CHANNEL A 
MOVW 1@Al1,#BAUD RATE 
MOVW 2@A1,#DATA WORD LENGTH 
MOVW 3@A1,#EVEN PARITY 
MOVW 4@A1,#STOP BITS 
MOVW 5@AL,#END LIST 
STL -Al,8@AQ 
BRK # 0 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
RS232C SVC NUMBER 
EQUW 55 
PARAM LIST 
RDATAB 6,2 
CHANNEL A 
EQUB "A 
BAUD RATE 
EQUB 3 
DATA WORD LENGTH 
EQUB 7 
EVEN PARITY 
EQUB E 
® 
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EQUB i 
END LIST 

EQUB py) 
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SETBRK Function Code 269 
Set <BREAK> 


Lets you enable the <BREAK> key by defining a <BREAK>-key 
processing program. 


Whenever the <BREAK> key is pressed, your processing program 
takes over. On entry to the <BREAK> processing program, the 
return address of the interrupted routine is on the User 
Stack and can be returned to with an RTR instruction (return 
with restore). 


See 'PROGRAMMING WITH USER INTERRUPTS' for further 
information. 


Entry Conditions 


Byte-offset 9-1 269 
6-7 switch 
6 = Off (normal TRSDOS-16 break 
processing ) 
1 = On (user programmed break 


processing) 
2 = Disable (TRSDOS-16 ignores 
<BREAK> key completely) 
8-11 transfer address 
@ = Fetch 
non-zero = store 


Exit Conditions 
Byte-offset 2-3 error code 


The transfer address is the address you want to jump to 
when the <BREAK> key is pressed. It must be even. 


Example 
SETBRK LD@ -A®S,SVC BLOCK 
MOVW @AG,#SETBRK SVC NUMBER 
MOVW 6@AG,#SWITCH ON 
MOVL 8@A0,#TRANSFER ADDRESS 
® 
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BRK # 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
SETBRK SVC NUMBER 
EQUW 269 
SWITCH ON 
EQUW 1 
TRANSFER ADDRESS 
EQUL H'8 P08 
® 
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SETTRP Function Code 266 
Sets a Trap Vector 


Allows you to set or remove a trap vector. When a BRK is 
executed (either through the BRK-BRKV instructions or an 
error trap) control goes to the address specified by the 
user. See SETBRK and PROGRAMMING WITH USER INTERRUPTS for 
further information on interrupts. 


Entry Conditions 


Byte-offset G-1 266 
6-7 function code 
8-9 vector number 
19-13 vector address 


Exit Conditions 


Byte-offset eo3 error code 
14-17 previous vector address 


The function codes are: 
@ - Install (SET) trap 
1 - Remove trap 
2 - Remove all traps (except BRK Q@) 


The available vector numbers are: 


Vector # Assignment 


tere es Trap vectors 1-15 

LG Illegal Instruction 

a ae zero Divide 

18 CHK Instruction 

19 TRAPV Instruction 

29 Privilege Violation 

ak Line 191@ Emulator 

22 Line 1111 Emulator 

23 Access out of Partition 
24 Odd Address Error 


Note that BRK @ is reserved for implementation of supervisor 
calls. 
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The Emulators (Vectors 21 and 22) are illegal opcodes which 
can be trapped. These are opcodes that have an 'A' or 'F'! 
in the first nybble (high order 4 bits). That is Axxx or 
FxxxX aS an opcode. 


The vector address is the address to jump to when the trap 
is executed. It must be even. 


Example 
SETTRP LDA -AG,SVC BLOCK 
MOVW @AG,#SETTRP SVC NUMBER 
MOVW 6@AG,#SET TRAP FUNCTION 
MOVW 8@A0,#TRAP 16 
MOVL 19@AG,#TRAP 16 ADDRESS 
BRK #0 
TESTW 2@AR 
BNE ERROR 
SVC BLOCK 
RDATAB 32,2 
SETTRP SVC NUMBER 
EQUW 266 
SET TRAP FUNCTION 
EQUW g 
TRAP 16 
EQUW 16 
TRAP 16 ADDRESS 
EQUL H'599@¢ 
® 
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UNLOCK Function Code 136 
Unlock Record 


Unlocks a specified record number, or all records within a 
specified file, that you previously locked. 
See READNX or DIRRD for information on how to lock a record. 


Entry Conditions 


Byte-offset 0-1 136 
6-7 file identification number 
8-9 record number 


Exit Conditions 
Byte-offset 23 error code 


The record number contains the logical record number of 
the file to be UNLOCKed. Specifying a -l in the record 
number byte-offset UNLOCKs all the records in the file 

which are locked by the calling user. 


The file identification number is a unique number assigned 
to each file when it is opened. 
Example 


Before executing this program, store the file identification 
number in register Al. 


UNLOCK LDA .A®,SVC BLOCK 
MOVW @AG,#UNLOCK SVC NUMBER 
STW .Al,6@AQ 
MOVW 8@A®,#UNLOCK ALL RECORDS 
BRK # 
TESTW 2@Ag 
BNE ERROR 
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SVC BLOCK 
RDATAB 32,8 
UNLOCK SVC NUMBER 
EQUW 136 
UNLOCK ALL RECORDS 
EQUW -l 
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VDCHAR Function Code 8 
Video Character 


Outputs a character to the display at the current cursor 
position. 


TRSDOS-16 ignores the control codes not listed in the 
following chart. 


KEY HEX FUNCTION 
CODE 
Fl Ol Blinking cursor on. 
F2 G2 Cursor oft, 
CTRL D G4 Turns on steady cursor. 
BACKSPACE 98 Moves cursor back one position and blanks 
the character at that position. 
TAB g9 Advances cursor to next tab position. Tab 


positions are at 8-character boundaries, 
Oe Oe 2a Sey ae Se 


CTRL vg OA Line feed--cursor moves down to next row, 
same column position. 
CTRL. K OB Positions cursor to beginning of previous 
line. 
ENTER OD Moves cursor down to beginning of next line. 
CTRL N OE Turns dual routing on. 
CTRL O OF Turns dual routing off. 
CPR tT 14 Homes cursor (upper left corner) 
CTRL W as Erases to end of line, cursor doesn't move 
CTRL X 18 Erases to end of screen, cursor doesn't 
move. 
CERI: -¥ 19 Sets Normal Display mode (white on black). 
Remains Normal until reset by programmer. 
CTRL Z 1A Sets Reverse Display mode (black on white). 
Remains Reverse until reset by programmer. 
ESC 1B Erases screen and homes cursor (position Q). 
left arrow LC Moves cursor back one position. 
right arrow 1D Moves cursor forward one position. 
up arrow 1E Sets 8@ character line and clears Display. 
down arrow 1F Sets 48 character line and clears Display. 
® 
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Entry Conditions 
Byte-offset g-1 8 
6-7 character to output (9-127) 
Exit Conditions 
Byte-offset 2°35 error code 


Example 


This routine clears the screen. 


VDCHAR LDA .Af,SVC BLOCK 
MOVW @AG,#VDCHAR SVC NUMBER 
MOVW 6@AG,#CLS 
BRK 3) 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,8 
VDCHAR SVC NUMBER 
EQUW 8 
CLS 
EQUW H'1E 
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VDINIT Function Code 7 
Video Initialization 


You might want to call this routine before starting any I/O to 
the Video Display. It blanks the screen and homes the cursor 
(moves the cursor to the upper left corner of the video 
display). 


Entry Conditions 
Byte-offset g-1 7 
6-7 character size switch 
@ = 48 characters/line 
non-zero = 8@ characters/line 
8-9 normal/reverse switch 
@ = reverse mode (black on green/ 
black on white) 
non-zero = normal mode (green on 
black/white on black) 


Exit Conditions 


Byte-offset 2-3 error code 
Example 
VDINIT LDA .AZ,SVC BLOCK 
MOVW @AG,#VDINIT SVC NUMBER 
MOVW 6@AG,#CHAR8G 
MOVW 8@AM, #+NORMAL 
BRK +O 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
VCINIT SVC NUMBER 
EQUW 7 
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VDLINE Function Code 9 
Video Line 


Writes a specified text buffer to the display, starting at the 
current cursor position. The text buffer must contain codes less 
than H'8Q@. 


Entry Conditions 


Byte-offset G-1 9 
6-7 buffer size (@ - 255) 
8-9 terminator character to be sent 


after the buffer text 
19-13 buffer address 


Exit Conditions 


Byte-offset 2=3 error code 
L4a=15 on error (number of characters not 
sent) 
L6=17 on error (character causing error) 


The buffer pointed to by the buffer address should contain 
ASCII codes in the range @ to 127. 


This routine handles control codes in the buffer in the same 
manner as in the VDCHAR routine. 
Example 


This example retrieves the buffer size, terminator 
character, and buffer Address from the KBLINE SVC routine. 


LDW -Al,12@A® *Get length of input line 
LDW .A2,14@AG@ *Get terminator character 
LDA .A3,KEYBD BUFFER *Get address of buffer 
VDLINE LDA .AS,SVC BLOCK 
MOVW @AG,#VDLINE SVC NUMBER 
STW .Al,6@AQ 
STW .A2,8@AG 
STL .A3,18@AR 
® 
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BRK +O 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
VDLINE SVC NUMBER 
EQUW 9 
® 
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VERSION : Function Code 137 
Get Version of Operating System 


Determines the version of software currently servicing 68999 
requests. 


Entry Conditions 
Byte-offset 9-1. 13} 


Exit Conditions 


Byte-offset 2s error code 
6-7 major version level 
8-9 minor version level 
19-11 patch level 


The major version level is the integral portion of the 
version number printed during startup. 


The minor version level is the fractional portion of this 
quantity. 


The patch level is any level following the version number. 


For example, version 2.fa returns major version level 2, 
minor version level §, and patch level ‘a’. 


Example 
VERSION LDA .A®,SVC BLOCK 
MOVW @AG,#VERSION SVC NUMBER 
BRK #6 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
VERSION SVC NUMBER 
EQUW 137 
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VIDKEY Function Code 12 
Video Key 


This routine combines the functions of VDLINE and KBLINE. 


It writes a buffer of data to the display, starting at the 
current cursor position, then waits for a line from the 
keyboard. 


Once the text message has been displayed, the cursor will be 
positioned immediately after the last character displayed. 
To move it to another position, a control code can be placed 
at the end of the text buffer. 


VIDKEY then uses KBLINE to get a line from the keyboard. 
Note that before starting the line input, all previously 
stored keystrokes are cleared. 


Refer to KBCHAR and VDCHAR for a list of control codes and 
other details. 


Entry Conditions 


Byte-offset g-1 12 
6-7 number of characters to be 


displayed (#-255) 
8-9 length of keyboard input field 


(8-255) 
19-13 address of keyboard input buffer 


14-17 address of display text buffer 


Exit Conditions 
Byte-offset 23 error code 
Le8=1L9 on error (number of characters not 
sent) 
208-21 on error (character causing error) 
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Example 
VIDKEY LDA .A®,SVC BLOCK 
MOVW @AG,#VIDKEY SVC NUMBER 
MOVW 6@AG,#DISPLAY COUNT 
MOVW 8@AG,#INPUT COUNT 
LDA .Al,KEYBD BUFFER 
STL .Al, 19 @AG 
LDA .Al,MESSAGE PROMPT 
STL .Al,14@AG 
BRK # 0 
TESTW 2@AG 
BNE ERROR 
SVC BLOCK 
RDATAB 32,0 
VIDKEY NUMBER 
EQUW 12 
DISPLAY COUNT 
EQUW Oo 
MESSAGE PROMPT 
TEXT 'ENTER THE ANSWER HERE! 
INPUT COUNT 
EQUW 20 
KEYBD BUFFER 
RDATAB 20,2 
® 
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WRITNX Function Code 43 
Write Next Record 


Writes the next record after the last record accessed; i.e., 
this routine writes records sequentially. 


If WRITNX is the first access after opening the file, it 
writes the first record. 


Entry Conditions 


Byte-offset g-1 43 
6-7 file identification number 
8-11 record buffer address 


Exit Conditions 
Byte-offset 23 error code 


The file identification number is a unique number assigned 
to each file when it is opened. 


The record buffer address is a 32-bit address that points 
to the beginning of a 256-byte Record Buffer; that is where 
the record will be placed after the disk read. 


Example 


Store the File Identification Number in register Al before 
executing this routine. 


WRITNX LDA -A@,SVC BLOCK 
MOVW @AQO,#WRITNX SVC NUMBER 
STW .Al,6@AG 
LDA -A2,RECORD BUFFER AREA 
STL .A2,8@A9 
BRK #0 
TESTW 2@AG 
BNE ERROR 
® 
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SVC BLOCK 
RDATAB 32,8 
WRITNX SVC NUMBER 
EQUW 43 
RECORD BUFFER AREA 
RDATAB 256,20 
® 
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APPENDIX A / Error Messages 


There are three kinds of error messages you might get while 
using your computer: 


- Boot Errors, such as BOOT ERROR DC. See the 
BOOT ERRORS TABLE for more information. 


. Operating System Errors, such as PROGRAM NOT 
FOUND. See the SYSTEMS ERRORS TABLE for more 
information. 


- Application Program Errors -- see your 
application program manual. 


When an error message is displayed: 
- Try the operation several times. 


- Look up boot errors and operating system errors in 
the following tables and take the recommended 
actions. See your application program manual for 
explanations of application program errors. 


- Try uSing other diskettes. 

- Reset the Computer and try the operation again. 
- Check all the power connections. 

- Check all interconnections. 


- Remove all diskettes from drives, turn off the 
Computer, wait 15 seconds, and turn it on again. 


- If you try all these remedies and still get an 
error message, contact a Radio Shack Service 
Center. 


Note: If there is more than one thing wrong, the 
Computer might wait until you correct the first error 
before displaying the second error message. 

RSSC = Radio Shack Service Center 
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Explanation/Action 


SVC block or the SVC argument 


is not within the memory range. 


Attempt To Open A 
File Which Has Not 
Been Closed. 


Close the file before 
re-opening. 


BOL. 


Specified record number is 
past the end of file. 


Attempt To Use A 
NON Program File 
As A Program. 


File specified for 

execution is not a program 
file or the load address 
given is illegal. Make sure 
you have a system diskette in 
Drive @. 


Check the format of the 
SVC block for errors. 


Bad Function Code 
On SVC Call Or No 
Function Exists. 


Check the function code number 
used on the SVC call. 


Character Not 
Avallable. 


No record or character 
was available when you 
called the SVC. 


CRC Error During 
Disk 1/0. 
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Message pep eraetonecttos Code 
DCB Is Modified And DCB (used in machine- 16 
Is Unusable. language programming) has 


been modified since the last 
disk file access (while 
the file was Bpete 


Data Lost During Disk Contact. RSSc . 41 

I/O (Hardware Fault). 

Debug Not Configured Include DEBUG at configuration £35 
time. 

Device Not RS AGReS s For nuieee -user only. re 

Device Not Available. For multi-user only 136 

Directory Read Error. Error occurred during an Ly 


attempt to read the directory. 
Try a different diskette. 
Directory Space Full. Number of filenames has reached 26 
the amount set when you 
formatted the diskette. 


Directory Write Error occurred during an 18 
Brror. attempt to write to the 
directory. Use a different 
diskette. 
Disk Drive Not Drive door is open or the 8 
Ready. diskette is not in the drive. 


On Thinline drives, check the 
Drive command settings. 


Disk Is Write Write enable the disk. cs 
Protected. 
Disk Sector Not Try a different diskette. 5 
Found. 
Disk Space Allocation Use the COPY command to copy 33 
Cannot Be Made Due To the files and reduce 
Fragmentation Of fragmentation. 
Space. 
® 
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Message Explanation/Action Code 
Disk Space Full. No space is available on the ra | 
disk. 
DO-Nesting Not A DO command was encountered 128 
Allowed. within a DO file. 
File Access Denied You gave an incorrect password. 25 
Due To Password See ATTRIB command. 
Protection. 
File Already In Filename already exists as see 
Directory. a directory entry. Kill 


the existing file, choose 
another filename, or specify a 
drive number. 
File Not Found. Filename you gave was not found 24 
on the available disks or the 
file is the incorrect type for 
the desired operation. 


Hardware Fault Contact RSSC, 49 
During Disk I/O. 
T/O Attempt To An Open the file before access. 38 
Unopen File. 
Tllegal I/O a. MOUNT/DISMOUNT commands 39 
Attempt. not given during a diskette 

Swap. 


b. Can be caused by an I/O 
attempt to a differently 
formatted disk. Format the 
Gdisk under the current version 
of TRSDOS-II/16 or use FCOPY. 
c. When initializing a hard 
disk, you must also format 
the secondary drives. 
Tllegal Disk Change. The operating system detected F 
an illegal disk swap. 


AS ES SPREE RS SEED EE OEE RE LE ED ES NSD ET EE ED ERED ED SED pee PRED CEN —REREED {PUES SOURED “RONDO SGD AGES SEED OED OGD ED ES ES ES AED ED SE ED ED EES AS ED OED SOT AED OWED ED ED ED “ED AOD OED ae Se —— —_ _ 
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Message Explanation/Action Code 
Tllegal File Type. File type you used (FLR or 144 
VLR) is not the type required 
by the system. 
Illegal Operation For multi-user only. 134 
Requested. 
Improper File Name Filespec you gave does 19 
(Filespec). not meet the standard file 
specifications. 
Incorrect Command Option or argument given 48 
Parameter. in the command is incorrect. 
Invalid Data Provided Data stream to be processed 9 
By Caller. has illegal characters. 
Invalid Space The space descriptor that 59 
Descriptor. tells the operating system 
which extent to read next is 
invalid. Try a different 
diskette. 
Maximum Of 16 Files Too many files are open 1d 
May Be Open At Once. at once. 
Memory Fault During Program is loaded incorrectly, 35 
Program Load. possibly because of faulty 
memory or a "bad" load address. 
No Drive Available No on-line drive 12 
For An Open. a. 1S write enabled 
b. has enough space to create 
a new file, or 
c. has a system directory. 
No Error Found. No error occurred. 4) 


SS SS ERD ED OEE SU EE ED OED CUES EE ED wD ED EE ee RE ED ee SD UE RED ED <n ne re ee ee SO cee ee ee ee ee ew ae 
SS DS OD RE NE ED ED ED RE ED EE OR RE ED ED EE SE AED DEED SED SUED cE “GEES eee ~cEmD aE ED ee ee ee SRD QS ee ee Se ee ee eee ee ee ee ee ee ee ee oe ee cee eee eee coe oom mee owe 
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Message Explanation/Action Code 
No More Extents Use the COPY command to copy 39 
Available (16 the files and reduce 
Maximum). fragmentation. See also SAVE/ 


RESTORE and MOVE. 


Not Applicable To Operation performed is not 46 
VLR Type Files. valid for VLR files. 
Odd Address. Address required by the SVC 132 
block must be even. 
Open Attempt For A File specified for open ee 
File Already Open. is already open. 
Out Of Range (Address Overflow occurred in the user L39 
Brron. stack during the SETBRK SVC 
or SETTRP SVC operation. 
Parameter Error On Parameter iS incorrect or a 3 
Cali, required parameter is missing. 
Parameter For Open Check the OPEN statements or 36 
Is Incorrect. the DCB for errors. 
Printer Fault (May Check the connections, power, 44 
Be Turned Off). ribbon, on-line status, and so on. 
Printer Not Check the connections, power, 45 
Available. ribbon, on-line status, and so on. 
Printer Not Ready. Check the connections, power, 42 


ribbon, on-line status, and so on. 


mee cme eee ee ee ee ee eee ee we ee ee ee ee ee ee ee ee ee) ee ee ee eee ee ee ee ee ee eee eee 


Printer Out Of Paper. Check the printer's paper 43 
supply. 7 
Program Not Found. Specified program is not found aL 


on available disks. 


Read Attempt Outside Use valid record numbers. 29 
Of File Limits. 


ee ee eee ee ED REED SUED OREUED RSENS MCCS OED ED RD ND ED SORE FED AAD SN ED ED UE OE ED ED ED EE OEE ED TEED SEED AED A re a SS A A A ED TD OS AD UD A OE ED ES OE AD RAD ED “OEE 
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Message Explanation/Action Code 
Required Command Required parameter or argument 47 
Parameter Not Found. is missing from the command. 
Seek Error. a. Data cannot be read from the 49 


disk -- faulty disk. 


—_———e—e—— oo a ee ee ee ee ee ce ee ee ee ee ee we me ee ee oe ee ee wee ee ee ee ee ee ee ee eee we ee ne om ee em ee we ee ae we 


Too Many Pending For multi-user only. 142 
CaLiis. 

Unknown Drive Number Specified drive number is not oe 
(Filespec). valid. 

** Unknown Error Codes ** 29-23, 51-127 
Write Attempt To A File was opened for read 3 
Read Only File. only, not for read/write. 

Write Fault On Disk Error occurred during a write 14 
E7 Os operation. Try a different 


diskette. If the problem 
continues, contact RSSC. 


Soon Soran coma commune coremes, comme comes NS SD ES 0 ED ED RS ED RD SE DD a ee ree OD Om AOD ED Dre cm a ce ce ne OD OED Or -eD em eme OmE WD eve OED nD cD -cumD “um oun neu sue “D 
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ar ae error -- 


possibly a defective 


ROM. 


TRS-80 ° 


TECHNICAL INFORMATION 


Explanation/Action 


enip, 


BOOT ERROR DC 


Floppy disk 

controller error. 

a. Defective 
diskette. 

b. Floppy disk 
expansion unit 
not.-On. 

c. Defective FDC 
Chip or Drive. 

d. System was not 
powered up in 
the proper 
sequence. 


Try a different 
diskette. 

Turn on the 
floppy disk 
expansion unit. 
Contact RSSC. 


Turn Of ‘the 
Computer and 
power it up: in 
the proper 
sequence. 


BOOT ERROR D@ 


Drive not ready. 

a. Improperly 
inserted 
diskette. 

b. Defective 
diskette. 

c. Defective 
drive. 


Insert the 
diskette again 
and press <RESET>. 
Try a different 
diskette. 
Contact: RSsc. 


Re-initialize the 
hard disk or contact 
ROD. 


Controller error. 
Aborted command: 
Problem during 
boot-up of hard 
disk. 
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TECHNICAL INFORMATION 


Explanation/Action 


Re-initialize the 
hard disk: or contact 
RSSC. 


Controller error. 
Busy not reset. 


a. Re-initialize the 
hard disk. 

b. Power down, wait 
1@ seconds, and 
power up. 

TE the error occurs 

again, contact RSSC. 


CRC .@Lrror. 
Invalid. data in 
iy -E2LeLa. 


Re-initialize the 
hard disk. 


Data address 
mark not found. 


Re-initialize the 
hard disk. 


to nor reuna. 
No Boot Track. 


Re-initialize the 
hard disk. 


Track @ error 

on hard disk. 

a, Didnt. find 
Track @ before 
time-out. 

b. Secondary hard 
disk drives 
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be Turn on -vour 
secondary hard 
disk drives. 
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Message 


Time-out while 

waiting for Ready. 

a. Hard disk drive 
not powered up. 


b. Hard disk drive 
isn't. turned on 
and ready within 
1@ seconds after 
the computer. 

c. Hard disk drive 
is disconnected. 


TECHNICAL INFORMATION 


Explanation/Action 


a. Follow correct 
procedure: 
Turn on the 
hard disk first. 
b. Press <RESET>. 


c. Connect the 
hard disk drive 
or operate 
under floppy 
disk control. 


Lost data during 
read -- FDC (floppy 
disk controller) or 
drive, Lault, 


Try another 
system diskette 
or ‘contacc RSoc. 


Memory failure in 
address range 
X'1OOO'-X'T7FFF'. 


Memory failure in 
address range 
X'8OCO'-X'FFFF'. 


Memory failure in 
address range 


X'OPOO'-X'OPFFF'. 


Turn on the 
expansion bay if it 
iS. OLE... Ti the 
error occurs again, 
contact RSSC:. 


ES ED NY SS ED OE A OS UY EES ED NE ED NED OE ED ND «ED 
SSS aS SS eS ES SS Sn en ee ee en ee ee ee ee ee ee ee ee ee ee ene eee ee ee eee eee eee ee ee e_eee_ eee ee eee ee ee eee ee ee ee eee eee 
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Message 


TECHNICAL INFORMATION 


Explanation/Action 


ES A ES ee EE ED SUSE REE TEE RE DE ED RU CREE SEED -GREED EES SE OEE EES SOURED cD came ACHE SUED GEER “AOGSD nen sone —eEED wom -neU COE SEED ccm eee ERED ED Se SEED SSD OUD Ome sD ee ED SD nD ED DD ee ee 
Sy ND ES A RE ED ORD ED eS ED RR ES SURED mE SORE ee URE CREED USED ROR AED EE ED SEE EE ED NOES OEE ED GED ED ED ED EEE ORD UD ED A ED ES ED en 


BOOT ERROR RS 


The diskette 

in Drive 9 is not 
Radio Shack operating 
system format. 


Insert a 
TRSDOS-II/16 
formatted diskette 
into Drive @ and 
Press <RESET>. 


CRC BEror: 

Invalid data on 
diskette or defective 
diskette. 


Try a different 
diskette. 


Record not found 
bootstrap track. 
Improperly formatted 


or defective diskette. 


Re-format your 
diskette or try a 
different diskette. 


i i i i ee re er i er i iil 


DISK 


Diskette in Drive 

@ isn't a TRSDOS-II 
operating system 
diskette. 


Insert a system 
diskette into 
Drive @. 


AD RNS SR ASOD RES OS ERE DR RS RS E-CARD Re eR ee EE SEGRE GS SORE cE SSE SOE Fe SNR GD ORE = EE CEN NE ED UE RED A AED OOD ED RE SE Der 
EES AE OOD AOD AAD SRD ERED ND RE ND RED NS SED SE A EE ES ED A SD RS SED ED EE OE RED RED COED SUED RD ED ME AS OS ER ED ED EE ED ED CD OD ED ED OE ANS SRD ED 
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APPENDIX B / The Configuration Command File 


Whenever TRSDOS-16 starts up or is reset, it looks for a 
file named CONFIG16/SYS. This "configuration command file" 
tells TRSDOS-16 to link in certain extra operating system 
programs. 


CONFIG16/SYS should be present on the primary disk device 
(Drive @ or Drive 4). It contains these directives: 


INCLUDE RUNCOBOL 
INCLUDE DEBUG 
END 


which tell TRSDOS-16 to link in the RUNCOBOL program and the 
DEBUG program. 


You may create your own CONFIG16/SYS file, or modify the 
existing one to meet your needs, by using EDITI16. 


SAVING THE EXISTING CONFIG16/SYS FILE 
Before creating a new CONFIG16/SYS file, you will probably 
want to save the existing one by renaming it. 
For example: 
RENAME CONFIG16/SYS:% TO DEBCOB/CFG: 9 


renames the default configuration file. (The new filename 
tells you it includes both DEBUG and RUNCOBOL modules. 


After renaming the existing CONFIG16/SYS file, you can 
create a new one. 


Since you "saved" the existing file, you can use it again. 
To do this, rename the present CONFIGI16/SYS file (if you 
want to save it) and then rename DEBCOB/CFG back to 
CONFIG16/SYS: 


RENAME DEBCOB/CFG:8 TO CONFIG16/SYS:9 
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TO EDIT OR CREATE CONFIG16/SYS 


Use EDIT16 to edit or create a CONFIG16 command file. 


i 


rype: 
EDIT16 <ENTER> 
and the Editor's Command mode prompt will be displayed: 
Or eS ale wie 616 SI See Re OS Eee oS 8 


To insert commands into the command file, you must get 
in the Insert mode, type: 


IN <ENTER> 


The Hditor will. display the 1? prompt, indicating that 
you are in the Insert mode. 


You are now ready to insert the names of the programs 
you want linked to TRSDOS-16. 


Comments may be used. They are indicated by an 
asterisk (*). in the. Tirse <coLiumn.. 


The key word INCLUDE tells TRSDOS-16 the 
name of the program. The syntax for the INCLUDE 


statement is: 
INCLUDE filename 

The default extension for filespec is /SYS; it is 
optional. Drive numbers, disk ID and Passwords are 
not permitted. 

Programs are loaded sequentially in memory in the order 
they are encountered in the CONFIG16/SYS file. The 
maximum number of programs that may be INCLUDEd is 15. 


The programs must be resident on the primary drive 
(Drive @ or Drive 4). 


The list is concluded with an END statement. 
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For example: 


* This is the Configuration File for DEBUG 
INCLUDE DEBUG 
END 


tells TRSDOS-16 to link only the DEBUG program. The 
first line is a comment and is not executed by 
TRSDOS-16 


4. When you are finished inserting, press <ENTER> to exit 
the Insert Mode. 


oe Save the file with the following command: 
SA CONFIG16/SYS <ENTER> 


G- You now have a new CONFIG16 command file that TRSDOS-16 
will use when it powers up or resets. 


CONFIGURATOR ERROR MESSAGES 


When the Configurator lists a line generating an error, it 
prints an error message directly underneath the line number. 
Preceding the message, it inserts three asterisks. 


In cases of certain syntax or file I/O errors, the 
Configurator also marks, with a dollar sign ($), where in 
the line the error occurred. 


For example: 
G11 INCLUBE RUNCOBOL 
*** Tllegal Command 
shows a syntax error in the spelling of INCLUDE. 


There are three catagories of Configurator error messages: 


A. Contiguration Control File Errors 
B. Configuration Command Errors 
Cs Completion Errors 
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A. Congifuration Control File Errors 
These errors are FATAL. If one of these errors occur, the 


Configurator could not properly execute the CONFIG16/SYS 
File. MTRSDOS-16 will still be displayed but certain 
defaults will have occured: 


Ly No programs have been INCLUDED 

2% DEBUG is kept resident (if available) 

ce Any memory not occupied by DEBUG and the resident 
Operating System is available to the user. 


Use EDIT16 to correct the error (or create a new 
configuration file) and reset the system. 


Can't Open CONFIG16/SYS: TRSDOS Error Code = nnn 
Look up TRSDOS-16 Error Code nnn in Appendix B and 
take appropriate action. 
Can't configure system: File CONFIG16/SYS not proper 
format 


The CONFIG16/SYS file is not a VLR type file. 


Can't configure system: File CONFIG16/SYS not found 


TRSDOS-16 could not find the CONFIGI16/SYS file. 


I/O Error on File CONFIG16/SYS: TRSDOS Error Code = nnn 


Look up TRSDOS-16 Error Code nnn in Appendix B and 
take appropriate action. 


B. Configuration Command Errors 


These errors occur when a command cannot be processed by the 
Configurator. If one of these error occurs, the 
Configurator will continue to process the command lines. 
However, the desired result of the configuration file may 
not have been accomplished. For example, an INCLUDE file 
may have been left out. 
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Can't INCLUDE program: MTRSDOS Error Code = nnn 
The Configurator cannot load the program because 
of an I/O error. Look up the TRSDOS-16 Error Code 
in Appendix B. 

Can't INCLUDE program: Out of Memory 
More resident programs were requested than will fit 
into user memory. 

Can't INCLUDE program: Program already configured 


This error occurs any time a program is included twice. 


Too many INCLUDED programs: this request ignored 
This error occurs if more than 15 programs are 


included. The command line that is flagged is ignored 
(treated as a comment). 


Ce Completion Error 
*** CONFIGURATION ABORTED *** 
This message appears when the configurator could not 


finish processing the CONFIG16/SYS file because of 
an I/O error. 


Radie Shaek 


2ST 


TRSDOS 16 OWNER'S MANUAL ‘ TECHNICAL INFORMATION 
TRS-80 


ABOUT THE CONFIGURATOR 


The Configurator is invoked whenever the 689@M processor is 
initialized. It performs several important functions: 


‘ It determines whether the machine debugger is 
required. If not, it is eliminated from memory. 
This gives you an extra 4K of memory. 


‘ It initializes traps and interrupts. This 
eliminates the need to keep extra code resident 
in memory. 


‘ It loads in resident programs as specified in 
the CONFIG16/SYS file. 


é It reads the AUTO file and passes it to 
TRSDOS-16 for execution. 


The Configurator is linked in at the end of user memory and 
occupies 4K of memory. Upon system initialization, it moves 
itself to the top of physical memory. This is because the 
resident programs will be loaded at low address, overlaying 
the original configurator. 


Next the Configurator begins to load the resident programs 
requested in the CONFIG16/SYS file (i.e., DEBUG and 
RUNCOBOL). It loads these programs sequentially starting at 
the beginning of user memory and up to the beginning of 
where the Configurator has relocated itself. This 
guarantees that after loading is complete, the user has at 
least 4K of memory available (the size of the Configurator). 


After configuration is complete, the Configurator is no 
longer neccessary and is overwritten. 
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fo’ 
APPENDIX C / Memory Map 
BEGINNING OF --> --------------------- 
MEMORY 
TRSDOS-16 
H'509@GB  j 9 aenn----------------- 
DEBUG 
IF LOADED 
| | 
H'609G@ jj 9 wennn---------------- 
RUNCOBOL 
IF LOADED 
BASE ADDRESS --> --------------------- 
rn 
USER 
MEMORY 
BOUNDS ADDR --> --------------------- 
MEMORY CHART 
User memory begins at H'5@@@ if the Debugger is not 
configured and at H'699@M if the Debugger is configured. 
L> 
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Code Character APPENDIX D 
; : ASCII 
WIdEO DISplay Character Codes 
Dec. Hex Keyboard Scroll mode Graphics mode 
ee — — 7 — 


01 01 | | Turns on blinking cursor 
02 C2 _ Turns off cursor 
03 03 


+7 : _ 
i883 


- 


a 


04 04 Turns on steady cursor 


ge 
8 


05 05 
06 06 
07 07 
08 08 Backspaces cursor and 
erases character 
Advance cursor to next 8- 
character boundary 

Line feed 

Cursor to previous line. 


09 09 


10 OA 
11 OB 
12 0C 


ace 


Ie 


13 OD Carriage return 
14 Oc | Dual routing on. 


15 amet (CTRL 0) Dual routing off. 
a ‘o Ga | 


1711 | (@nae 
Tes | CTRL) 
19 13 


20 14 |\(Gqiiben Homes cursor in scroll area. 
21 15 |@ 


ae 16 RLU 
23 17_—| (Gaia D Erase to end of line 
24 618 | fise@ | Erase to end of screen 
25 19 | (Gives Sets white-on-black mode 
26 srw h (CTRL Z) Sets black-on-white mode 
27 1B | (Ge) Clears screen, homes cursor 
28 cCik@ Moves cursor back. 
2 1D ic | Moves cursor forward 
30 «616 (TS)~____| Sets 80-character mode 
— + = ~=~=~=—saneceaecdicpey 
31 1F les) Sets 40-character mode 
and clears display 


* (BREAK) is always intercepted. It will never return a X’03’ 
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Code 


Key- Video Display 
board 


So. | ¢ 


-OomnOnk wm - Oo ~~) 


/ / 
0 0 
1 1 
2. 2 
3 3 
4 4 
5 5 
6 6 
7 7 
8 8 
9 9 


A .. 


9O0oOMr@ ~ yi! 
CoO@Mrg~ * ie 
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TRSDOS 16 OWNER'S MANUAL . TECHNICAL INFORMATION 
TRS-8O 


Key- | Video Display 
_board Scroll mode 
70 46 


a 
72 48 
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—itTO 7 71mMlvOwe 
—~- -sO *-*@ QAO OO ® 


Radie Shaek 


242 


TRSDOS 16 OWNER'S MANUAL 5 TECHNICAL INFORMATION 
TRS-8O 


Key- Video Display 
board Scroll mode 


106 GA 
107 6B 
i108 6c 
109 6D 
(#110 6E 
Aca 6F 
112 #70 
113 71 
114 7? 
115 73 
| 116 74 
147-275 
118 #7 
“499. 77 
120. 78 
Be, 
123. 7B 
125 7D 
127 Te 
128 280 


PJs <xe<csomovozerns 


ST napa aida a ww we eS 


_iIt+ ea -- ~=—N <MéamEee CH H A OG Oo SB 3 —x— 


_ Sets white-on-bla 
mode — 

Sets black-on-white 

Homes cursory 


* Codes 128-248 cannot be input from the keyboard or output to the display. 
When reading the display, a value greater than 127 indicates a reverse 
character corresponding to value mod 128. 
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TRSDOS 16 OWNER'S MANUAL ‘ TECHNICAL INFORMATION 
TRS-8O 


APPENDIX E / SVC Quick Reference List 


NAME DESCRIPTION NO. 
actL. »=—«‘wGomtol Channel Attéi‘“‘séOS™C~C~C~*~*~*~*CSCSW 
ARCV—Ss Channel A Receive = = = 96. 
ATX Channel ATransmit = $= = 97. 
BCTL Control Channel BO ti(‘<‘éOSOSOS;*;*;*;*‘CSZSC™SW 
BRCV. Channel BReceive = 98 
BTX Channel Rfranemit  |§#= $= = #99. 
CLOSE Terminates output to specified file. | (42 
CLOSEF | Terminates output to all open files | 133 | 
except OPENDO file 
CLRXIT Clear user memory and jump to TRSDOS-16 257 
Ready 
CURSOR Position cursor g§8#= $= #=§ 1g 
DATE Returns the real-time (time/date) = | 45 
DEBUG Load the Debugger i (tti(i‘ésezét~;*;*~*éSC*~*# 
DIRRD — Allows a specific record in an FLR file 35 


to be read. 


DOSCMD Execute TRSDOS-16 command and return 270 
to TRSDOS-16 Ready 

DUMP Writes a 68898 format program file from 139 
680908 memory. 

ERRMSG Returns an 8M@-byte descriptive error 52 
message for the requested error number 


ED CED RED CUED 1A ES RED EE AED SE EY ED ED ES ED APSE CREED REE ED NED SEES AES SURES OUEND SNEED GENS SNEED “OUST GED ED SED ED ES ED RED AOE OSE OED ED REED EE OED ED EP ED OE ED ED EE ED ee A  _ ETE _ 
ee eee cece cee ee ee ES ED OS ED ED A A RS AS OS AS CD A OD DS AES SOME A GND NED OS OED ED ES AS AN ED ED OED US RE ED ES ES AES AEE OMNES CCE CED GREED TREES RED OED mE eon SNEED cee eee sui MOREE GUND REEED <camD 
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TRSDOS 16 OWNER'S MANUAL TECHNICAL INFORMATION 


TRS-8SO ° 


NAME DESCRIPTION NO. 


ERROR Causes the error message purawaa to 39 
by ERROR NUMBER to be printed 
on the video display. 


EXECUTE Execute program 26 3 
HLDKEY Enable / Disable HOLD key 29 
JP2DOS Jump to TRSDOS-16 Ready 264 
KBCHAR Strobes the keyboard and returns with or 4 
without a character. 
KBINIT Initializes the keyboard input driver a 
KBLINE Inputs a line from the keyboard into a 5 
a buffer and echoes the line to the 
display. 
oo KILL Deletes the specified file from the 41 
| directory. 
LOAD Loads a 68@@@-format program into the 13 


user memory. 


LOCATE Returns the number of the current record. 33 
(i.e. the last record accessed) 


MOUNT Logically connects a disk device 138 
MOVBUF Retrieves and stores an 8f-byte buffer 267 
OPEN Handles both the creation and opening of 49 

files. 
OPENDO Opens and creates a special file not closed 149 

by CLOSEF 
PRCHAR Sends one character to the Printer, = #18 
PRCTRL Lets you select various printer options. | 95 
PRINIT Initializes the printer driver 17 

c~ 
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TRSDOS 16 OWNER'S MANUAL TECHNICAL INFORMATION 


TRS-8SO ° 
NAME DESCRIPTION NO. 
PRLINE sends a line to the Printer. ## |§ 18 
READNX Reads the next record after the current | 34 
record. 
RENAME Changes the name and/or extension of a file 47 
RESET Same as pressing the RESET switch = |= 129 
RS232¢. Initialize RS-232c Channel (iti(‘ésS@SC*~*# 
SETBRK Enable / Disable the BREAK key 269 
SRTPRR © bec oe cemove trap vectors 8 .. (sR 
CMLOCR  Unlbcke a specified record =8=~=~*~=C<“—t~‘“—*«~=:*«~S 
VDCHAR This routine outpus a character at the 8 
current cursor position. 
VDINIT Initialize the video Driver = —(‘ir;*# 
VDLINE Writes a buffer of data to the display |§ 9 
VERSION Get version of Operating System = 137 
VIDKEY Sends a prompting message to the display 12 


and then waits for a line from the keybd. 


WRITNX Writes the next record after the last 43 
record accessed. (i.e., sequentially) 
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